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Preface 



This publication describes the facilities 
provided with the job control language and 
contains the information necessary to code 
job control language statements . 



This publication can be used by 
programmers who are familiar with the job 
control language and are coding job control 
language statements. The publication may, 
for example, be used for review of a 
particular job control language statement 
or parameter, or for reference on how to 
code a parameter or what occurs when a 
particular parameter or subparameter is 
coded. 

This publication has five logical parts: 

1. Programming notes, which contain 
coding conventions used in coding job 
control language statements . 

2. Job control language statements, which 
describe the format of each statement 
and the format of the parameters 
associated with the statement. There 
is a separate section for each 
statement. 

3. Appendixes, which include additional 
information on the job control 
language facilities, such as how to 
write and use cataloged procedures, 
and what default values are provided 
when certain parameters are not coded. 

4. Glossary, which contains definitions 
of many of the terms used in this 
publication. 

5. Foldout charts, which show the format 
of JOB, EXEC, and DD statement 
parameters. The foldout charts appear 
after the index. 



Before you read this publication, you 
should understand the concepts and 
terminology introduced in the prerequisite 
publications listed below. In addition, 
the text refers you to other publications 
for detailed discussions beyond the scope 
of this publication. 



Prerequisite Publications 

IB^^- System/360 Operating System; 

Introduction , GC28-653U 

Concepts and Facilities , GC28-6535 

Job Control Language User's Guide , 
GC28-6703 



Publications to Which the Text Refers 

IBM System/360 Operating System: 

S ystem Programmer's Guide , GC28-6550 

U tilities , GC28-6586 

Operator's Guide , GC28-6540 

S upervisor and Uata Management Services , 
GC28-66U6 

S upervisor and Data Management Macro 
I nstructions , GC28-6647 

S torage Estimates , GC28-6551 

T ape Labels , GC28-6680 

Advanced Checkpoint/Restart Planning 
Guide, GC28-6708 
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Summary of Major Changes—Release 19 



Ihe Release 19 changes listed below are described in this manual, 
the text by a vertical line to the left of the change. 



They are indicated in 



Item 



Description 



Areas Affected | 
^ 



System Management 
Facilities Subset 1 



-+ 



The TIME parameter on the JOB and EXEC state- 
ments now applies to MET as well as MVT. 



28,61 ,66,97 



System Management 
Facilities Subset 2 



OUTLIM, a new parameter on the DD statement 
that specifies SYSOUT, allows you to limit the 
number of logical records you want included in 
an output dat^ set. 



102,177,203,303 



Input/Output 
Recovery Management 
Support 



REPOS, a new DCB subparameter that specifies 
repositioning for tape devices, has been added. 
A new command, SWAP, that allows Dynamic Device 
Reconfiguration of two volumes has been added. 



145,231,232 



Data Management 
Support for American 
National Standard 
COBOL 



Two new values for BFTEK, a DCB subparameter, 
have been added. A specifies record area 
buffering; R specifies record buffering. 



134-135 



249 5 Tape Cartridge 
Reader 



2495 is now supported. 



213 



Optical Readers 



VOLUME=SER=OCRINP is assumed for Optical readers 
if no volume serial number is specified. 1285, 
1287, and 1288 Optical Readers are now 
supported. O and H are new values for DCB 
subparameter OPTCD. O specifies on line 
correction for Optical Readers; H requests 
hopper empty exit for Optical Readers. 



142,143,212 



1419 Magnetic Tape 
Reader and 1275 
Optical Reader Sorte] 



1419 and 1275 are now supported. 



212,213 



-+- 



Recognition of 
EOF on Input 



B, a new value for DCB subparameter OPTCD, 
requests that end-of-file recognition be 
disregarded for tapes. 



142-143 



ISAM Improvements 



For ISAM, a newly created data set can now 
overlay an older one — reusing the space. The 
independent overflow area of an ISAM data set 
can now be on a different device type from the 
prime area- 



276,277,279,280 



(continued) 



Summary of Major Changes - Release 19 13 



(continued) 



-T 1 

I Areas Affected | 



Item 



Description 



Direct System 
Output Facility 



In MFT and MVT, an output data set can now 

be written directly to the desired unit record 

or magnetic tape device. 



203 



Seven-Track Tape 
Default of 8 00 BPI 



The default for 7-track tape is now 8 00 
bits-per-inch . 



138 



DD DUMMY Substitu- 
tion at Restart 



A data set that is not needed after restart can 
be defined by coding the DUMMY parameter. 



271 



15,18,75,8"5,23l),"! 
241-243,247-268, 
301 ,303 



In-Stream Procedures 



A facility has been added that allows procedures 
to be included in the input stream of a job. 



Main Storage 
Hierarchy Support, 
MVT Extension 



+- 



If you code the REGION parameter and request 
storage only from hierarchy 1, no hierarchy 
segment is allocated. 



54,93 



Blocksize Adjustment 
for Sysout Datei Sets 



If the BLKSIZE parameter for a SYSOUT data set 
is not an integral multiple of and larger than 
the logical record length, it is adjusted. 



135-136 
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The Format of This Publication « 



This publication is designed for easy reference. The first section of 
this publication contains information that is conuonon to all job control 
language statements; for instance, one of the topics in this section is 
how to continue a field onto another control statement. You may want to 
review Section I from time to time. 

Sections II through X contain descriptions and examples of the 
different control statements . The job control statements are described 
in the following order: 

1. The JOB statement. 

2. The EXEC statement. 

3. The DD statement. 

4. The command statement. 

5. The comment statement. 

6. The delimiter statement. 

7. The null statement. 
I 8. The PEND statement. 

9. The PROC statement. 

Each statement description includes the purpose of the statement and 
rules for coding the statement. Notice that the JOB, EXEC, and DD 
statements are described first, in the order in which they normally 
appear in the input stream- The remaining statements are described in 
alphabetical order. 

The statement description for the JOB, EXEC, and DD statements is 
followed by a chapter on assigning a name in the name field of the 
statement and a chapter for each positional and keyword parameter that 
can be coded on the statement. The chapters on positional parameters 
appear before the chapters on keyword parameters. Both positional and 
keywork parameters are described in alphabetical order. 

The format of the positional or keyword parameter appears at the 
beginning of the chapter. Each subparameter is then described briefly. 
The text following the format description of the parameter describes the 
purpose Df the parameter and each subparameter. Each chapter ends with 
examples on the use of the parameter and its subparameters . 

Section XI consists of Appendixes A through F. These appendixes 
include : 

I 1. Appendix A: Cataloged and In-stream Procedures 

2. Appendix B: Using the Restart Facilities 

3. Appendix C: Creating and Retrieving Indexed Sequential Data Sets 

4. Appendix Ds Creating and Retrieving Generation Data Sets 

5. Appendix E: Default Parameter Values Supplied in the Input Reader 

Procedure 

6. Appendix F: A Checklist 

Section XII is a glossary of terms used in this publication. 

Section XIII, which follows the index, is a set of foldout charts. 
These charts show the format of JOB, EXEC, and DD statement parameters. 
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Notation for Defining Control Statement Parameters 

The formats of the parameters described in this publication for the JOE, 
EXEC, and DD statements appear at the beginning of the chapter on the 
corresponding parameter. Notations used in the format descriptions are 
described below. 

1. Uppercase letters and words are coded on the control statement 
exactly as they appear in the format description, as are the 
following characters. 

ampersand & 

asterisk * 

comma , 

egual sign = 

parentheses () 
period 

2. Lowercase letters, words, and symbols appearing in the format 
description represent variables for which specific information is 
substituted when the parameter is coded. 

For example, PRTy=priority is the format description for the PRTY 
parameter. When you code the PRTY parameter on a JOB statement, 
you substitute a ntimber for the word "priority." 

3. Braces [ } are a special notation and are never coded on a control 
statement. Braces are used to group related items; they indicate 
that you must code one of the items . 



V 

ixze) 



For example, (trk ) is part of the format description 
<CYL 
I block s: 



for the SPACE parameter. When you code the SPACE parameter, you 
must code either TRK, CYL, or a substitute for "block size," which 
would be a number. 

4. Brackets [ ] are a special notation and are never coded on a 

control statement. Brackets indicate that the enclosed item or 
items are optional and you can code one or none of the items . 

For example, [, DEFER) is part of the format description for the 
UNIT parameter. When you code the UNIT parameter, you can include 
, DEFER in the UNIT parameter or omit it. 

An example of more than one item enclosed in brackets is 

tEXPDT=yydddj , which is part of the format description for the 
RETPD=nnnn J 

LABEL parameter. When you code the LABEL parameter, you can 
include either EXPDT=yyddd or RETPD=nnnn in the LABEL parameter or 
omit both. 

Sometimes, one of a group of items enclosed in brackets is a comma. 
You code the comma when none of the other items in the group is 
used and a following part of the parameter is still to be coded. 
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5. 



The comma indicates to the system that you have not selected to 
code any of the items enclosed in the brackets. 



For example. 



progname 



[,form «n umber ] ) is part of the format 



description for the SYSOUT parameter in systems with MFT and MVT. 
Wh€;n you code the SYSOUT parameter, you have the option of coding 
both ", progname" and ",form number", omitting both, or coding only 
one. The comma enclosed in brackets with ", progname" must be codcid 
when ", progname" is not coded but ",form number" is coded; that is, 
you would code: , , f orm number). 

An ellipsis . . . (three consecutive periods) is a special notation 
and is never coded on a control statement. An ellipsis is used to 
indicate that the preceding item can be coded more than once in 
succession. 



For example, COND=( (code, operator) ,... ) is the format description 
for the COND parameter on the JOB statement. The ellipsis 
indicates that (code, opera tor) can be repeated. 



Fields in Control Statements 



Every control statement is logically divided into different fields. 
There are four fields — name field, operation field, operand field, 
comments field — but not all of the control statements can contain all 
of these fields. Figure 1 shows the fields for each statement. 



1 Columns 1 
Statement | 1 and 2 | Fields 
+ ^ 

Job 1 // |name operation (JOB) operand^ comments^ 
Execute | // |name^ operation (EXEC) operand comments^ 
Data Definition 1 // |name^ operation (DD) operand comments^ 
PROC (Cataloged) 1 // |name^ operation (PROC) operand comments*^ 
PROC(in-stream) \ // jname operation (PROC) operand^ comments^ 
Procedure end \ // |name^ operation (PEND) comments^ 
Command | // | operation (command) operand comments^ 
Delimiter | /* | comments*- 
Null 1 // 1 
_ + + 

Statement | Columns 1,2,3 | Field 
4- 4- 


T T 

Comment | //♦ | comments 



H- 



|. 



^Optional 

^Optional — If an operand (s 

If an operand (s 



X ^ 



) is not coded, comments cannot be coded. 
) is coded, comments are optional. 



L . J 



Figure 



Control Statement Fields 



The na me field identifies the control statement so that other 
statements and system control blocks can refer to it. The name field is 
1 to 8 alphameric and national (#, a, $) characters; the first character 
must be alphabetic or national. The name field must begin in column 3. 

The operation field specifies the type of control statement, or, in 
the case of the command statement, the command. The operation field 
must follow the name field and must be preceded and followed by at least 
one blank. 
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The operand field contains parameters separated by commas. The 
operand field must follow the operation field and must be preceded and 
followed by at least one blank. The operand field is described in more 
detail in the next chapter "Parameters in the Operand Field." 

The comments field contains any information deemed helpful by the 
person who codes the control statement. The comments field must follow 
the operand field and must be preceded by at least one blank. 

Control statement fields — except the name field, which must tegin 
in column 3 — can be coded in free form. Free form means that the 
fields need not begin in a particular column. Separate each field with 
a blank; the blank serves as a delimiter between fields. 

Except for the comment statement, which can be coded through column 
80, fields cannot be coded past column 71. If the total length of the 
fields will exceed 71 columns, you must continue the fields onto one or 
more succeeding statements. How to continue fields is described in the 
chapter "Continuing Control Statements." 

Some examples of how the different fields appear on control 
statements are: 




Columns: 








1 2 3 








Name 


Operation 


Operand 


Comments 


/ / JOBS 


JOB 


MSGLEVEL=(1,1) 


THE FIRST STATEMENT IN JOB 


/ / STP1 


EXEC 


PGM=PROG4,REGlON=80l< 


EXECUTES PROGRAM NAMED PROG4 


/ / WORK 


DD 


UNIT=2400 


DEFINES A TEMPORARY DATA SET 



Parameters in the Operand Field 

The operand field is made up of two types of parameters: one type is 
characterized by its position in the operand field in relation to other 
parameters (a positional parameter) ; the other type is positionally 
independent with respect to others of its type, and is characterized by 
a keyword followed by an equal sign and variable information (a keyword 
parameter) . Both positional parameters and the variable information 
associated with keyword parameters can assume the form of a list of 
several items (subparameters) of information. 

All positional and keyword parameters and subparameters coded in the 
operand field must be separated from one another by commas. 

Positional parameters must be coded first in the operand field in a 
specific order. The absence of a positional parameter is indicated by a 
comma coded in its place. However, if the absent parameter is the last 
one, or if all later positional parameters are also absent, you need not 
code replacing commas. If cill positional parameters are absent from the 
operand field, you need not code any replacing commas. 

Keyword parameters can be used anywheire in the operand field with 
respect to one another. Because of this positional independence, you 
need not indicate the absence of a keyword parameter. 

A positional parameter or the variable information in a keyword 
parameter sometimes assumes the form of a list of subparameters . Such a 
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list may be composed of both positional and keyv?ord subparameters that 
follow the same rules and restrictions as positional and keyword 
parameters. You must enclose a subparameter list in parentheses, unlesa 
the list reduces to a single subparameter. 

The EXEC statements and DD statements in cataloged procedures can 
contain one other type of parameter — a symbolic parameter . A symbolic 
parameter is characterized by a name preceded by an ampersand (€); a 
symbolic parameter stands as a symbol for a parameter, a subparameter, 
or a value. Symbolic parameters allow you to make any information in 
the operand field of a procedure EXEC statement or DD statement 
variable. A value to be assumed by a symbolic parameter may be coded on 
the EXEC statement that calls the procedure. This value is in effect 
only while the procedure is being executed. For a detailed discussion 
on how to assign values to symbolic parameters, refer to the chapter 
"Assigning Values to Symbolic Parameters" in Appendix A; for a detailed 
discussion on how to use symbolic parameters in a set of control 
statements that you plan to catalog as a procedure, refer to the chapter 
"Using Symbolic Parameters in a Procedure" in Appendix A. 



Continuing Control Statements 

when the total length of the fields on a control statement will exceed 
71 columns, you must continue the fields onto one or more succeeding 
statements . 

The command, comment, delimiter, cind null statements cannot be 
continued - 

You can continue the operand field or the comments field. To 
continue either of these fields, you must follow the continuation 
conventions. 

To continue the operand field : 

1. Interrupt the field after a complete parameter or subparameter, 
including the comma that follows it, at or before column 71. 

r T-~lb T] -j^^-j T ^ -- ^^■^^-^--- y 31-40 " [ " " 41-50^ " 2] r 51-60 ^ """ [ " 6 '~^Q C ~ 71-80 

[iiiiirsiiiKSiEiLgiiigiiiizMiM 

2. Comments can be included by following the interrupted field with at 
least one blank. 



I-IO 11-20 



27-30 1^^ 31-40" T 41 -50 | 51 -60 61-70 '^.'-SO 



ll3T4T5T6T7T8l9T0TT r2T3l4T5T6m8T9T6h 



\/jfiJ).-/\ 3.b. . \2>.S- M.ASie^.P,ff,o ^,¥,3.f.f[jU)J,^.P\-/M£M.,/<,&£P\, ,i',^/,gr7".gJ,...4MrA„l3.i£ZLui^g.g, ,T >|^ i 7- | g i^i, 



3. Optionally, code any nonblank character in column 72. (The 
nonblank character in column 72 is reguired only when you are 
continuing a comments field.) If you do not code a character in 
column 72 when continuing the operand field, the system treats the 
next statement as a continuation statement as long as you follow 
the conventions outlined in items U and 5. 
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I-IO 


11-20 


21-30 31-40 


41-50 


51 


-60 


1 


61-70 


71-80 


i|2|3|4|6|6|7|8l9|0 


I|2|3|4|5r6|7|8|9l0 


1 |2|3|4|5l6|r|8|9|0 1 I2|3|4|5|6|7|8|9|0 


|2|3|4|5|6|7|8|9|0 


I|2|3|4|5|6l7l8l9l0|ll2l3|4|5i6|7|8|9|0 


l|2|3|4|5|6|7|8|9|0 


/jDM\ 1>J). , 


p,j-,/v:/}/?ie; = 


Pi^iO 


m^,g.S\, .D, LS,P\^(^,eM, .K£,£f\ 


;sx£.Lf\r,i^X , 


^A(rA. 


\S,£X. 


.fjo,^, 


,721^,7-,^,^ 


,X, 


, , 1 . , , , 



4. Code the identifying characters // in columns 1 and 2 of the 
following statement. 



.l|2[3|4|5l6T7|8l9l0 



11-20 
TT2I3I4I5I6I7I8I9I0 



21-30 
l|2l3|4|5|6|7]8T9l0 



71213 1 4151617181910 



41-50 



I |2|3l4|5|6|7 T8l9T0 



l| 2|3 |4|5[6l7T 8T9lO 



ms 



6 1 - 70 r~_7 1 -60 

l4r5|6l7[8l9Sl]:i2i3i415]6lrl8[?]0 



id. 



1/ I I I ' I I I ■ 1 I I 'I I I I I I I I 



-Li-j^a i I I I I I I 



-^--— 1^— -L' 



5. Continue the interrupted operand beginning in any column from 4 
through 16. (If you begin coding after column 16, the system 
treats the field as a comments field.) 



I 1-10 



:ii2|3|4|5|6|7| 8l9|o|l|2|3|4|5|6r7| 8|9TolT]2T3l4T5l6l7T8l^ 

I/,/, ,^,A/i^7:^,J^|/7 jy,6i^,aA£^|,s,g,/g-.fiir;3,?:g,i|j,.s, ^,Aog,^/,/,0 |0, ,/,/,.yifl,j,d? , ^J | ), , , , i , , , , | , , . , i , ,, , , | , , , , i ,..^_^ 



To continue the comments field: 



1. Interrupt the comment at a convenient place before column 72. 



\ l-IO 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 


ll|2|3|4|5|6|7|8|9|0 


lL2|3|4l5|6|7l8|9|0 


1 12131415 |6|7|819|0 


I|2|3l4l5|6l7l8l9l0 


Ii2|3|4|5|6l7|8|910 


Il2l3|4l5|6|7l8|9|0 


1|21314I5|6|718I9I0 


I|2|3l4|5|6|7l8l9l0 


1 



2. Code a nonblank character in column 72, 



1-10 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 


Il2i3|4l5|6l7|8l9|0 


Ii2|3l4l5r6l7l8l9|0 


II213I4I5I61718I9I0 


I|2|3|415|61718I9I0 


I|21314|5|6I7|8|9|0 


1|2|3|4|5|617|8|9|0 


I|2i3l4l5l6|7l8|9|0 


1|2|3|4I5|6|7|8|9|0 


fJ&f.e\Pj, , , |ex,^G i^6A=./)|y,/,9,^,f2i£-,<?,/,o,V|^,;i^6,/<,.iR2>=,ft^p,^/?,7:yi=,C,/,i,;|/,J,), , \%£.s,ixxf,s, ,oF\ r,£.srr\ X . . i . . . . 



3. Code the identifying characters // in columns 1 and 2 of the 
following statement. 



1 |2l3l4l5|6r7l8l9|0| I |2l3l4l5T6l7l8l9|o| 1 |2|3l4|5|6l7|8|9|ol I |2 | 3|4|5l6|7l8l9|o | I |2|3|4|5|6|7 | 8l9lol 1 12l3|4i5l6|7|8|9| o | 1 |213 |4| 5|6|718|9|0I 1 12|3|4[51 (>|7|8|9|0 

/l / l I I I I I I . I I ■ I M 1 -1 I I I I I I I I I , I I I I I I . I I I I t _| I I I , I .L-JL ... I .1 I I . I .1 ,,.l. , I ..... , Ll . . . I I . a-L-Lj,,X_L_i_ 



4. Continue the comments field beginning in any column after column 3 



1-10 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 


1|21314|5|61718|9|0 


1|2|3|4|5|617|8|9|0 


1121314151617181910 


Il2l3|4|5l6l7|8l9|0 


I|213|4I5I6I71819J0 


1121314|5|6|7|81910 


1|213|4|51617|819|0 


112l3l4l5|.ol7l8|9|0 


//, , , 1 , , , , \S,^^.u,L\h £e. \s.eM.r. \ro, M\. , .ec.K\eat . i , , , , i , , . , | . , , , | . , , , | .... i ... . 



Any control statements in the input stream, other than a comment 
statement, that the system considers to contain only comments have //* 
in columns 1 through 3 on an output listing. Any control statements in 
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a cataloged procedure, other than a comment statement, that the system 
considers to contain only comments have XX* in columns 1 through 3 on an 
output listing. For a comment statement, *** appears in columns 1 
through 3 on an output listing. 



Backward References 

A facility of the job control language allows you to refer the system to 
an earlier DD statement in the job for certain information. A backward 
reference is of the following form: 

• parameter=*,ddname — use this form when the earlier DD statement is 
contained in the same job step. 

• parameter=*.stepname.ddname — use this form when the earlier DD 
statement is contained in an earlier job step. 

• parameter=*.stepname.procstepname.ddname — use this form when the 
earlier DD statement is contained in a cataloged procedure called by 
an earlier job step. ("Stepname" is the name of the step that calls 
the procedure . ) 

You can use the backward reference facility only with certain 
parameters. These parameters and the information the system obtains 
when the backward reference facility is used are: 

• PGM — the data set that contains the program to be executed in this 
job step. 

» DCB — all DCB subparameters coded on the earlier DD statement. (If 
you code any DCB keyword subparameters following the backward 
reference, these subparameters override any of the corresponding 
subparameters coded on the earlier DD statement. If a DD statement 
defines an existing data set and contains a backward reference in 
the DCE parameter, the system copies only those subparameters from 
the earlier DD statement that were not previously specified for the 
existing data set.) 

• DSNAME — the name of the data set being defined on this DD 
statement . 

« VOLUME=REF — the volume serial n\amber(s) on which the data set 
resides or will reside; unit information is also obtained by the 
system. 



Concatenating Data Sets 

Up to 255 sequential or up to 16 partitioned input data sets, each of 
which may reside on a different volume, can oe logically connnected for 
the duration of a job step. To concatenate data sets, simply omit the 
ddnames from all the DD statements except the first in the sequence. 
When this ddname is encountered in a data control block in the 
processing program, each data set is automatically processed, in the 
same sequence as the DD statements defining them. 

If concatenated data sets have unlike characteristics, e.g., the 
device types, block lengths, or record formats differ, the DCBOFLGS 
field of the data control block must be modified while the program is 
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executing. For details, refer to the topic "Concatenating Sequential 
and Partitioned Data Sets" in the Supervisor and Data j^angement Services 
publication . 

If you make a backward reference to a concatenation, the system 
obtains information only from the first data set defined in the 
sequence . 

You should not concatenate other data sets to a data set you have 
defined using the DUMMY parameter. Vjhen the processing program asks to 
read a diammy data set, an end-of -data-set exit is taken immediately and 
any concatenated data set is ignored. 




The following example illustrates a group of DD statements defining 
concatenated data sets, including a data set in the input stream. 

DSNAME=A.B.C,DISP= (OLD, DELETE) 
DSNAME=X.Y. Z,DISP=OLD,LABEL= ( ,NL) 
DSNAME=ALPHA,UNIT=2311,V0LUME=SER=P12,DISP= (OLD, DELETE) 



//INPUT 


DD 


// 


DD 


// 


DD 


// 


DD 



data 



/* 



Character Sets 



Job control statements are coded using a combination of the characters 
from three different character sets. The contents of each of the 
character sets are described in Figure 2. 



Character Set 



Contents 



Alphameric 




Alphabetic 




A 


through Z 




1. . . 


Numeric 


1 





through 9 






"At" sign 


T 




a 


National 


i 


Dollar sign 
Pound sign 


_ J 




$ 
# 






Comma 

Period 

Slash 


T 




/ 


Special 




Apostrophe 

Left parenthesis 

Right parenthesis 

Asterisk 

Ampersand 

Plus sign 

Hyphen 

Equal sign 

Blank 






+ 



L X . X J 



Figure 2. Character Sets 
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when you code any special characters, certain rules must be followed 
These rules and the use of special characters are described next. 



Using Special Characters 

Special characters are used in the job control language to: 

1. Delimit parameters (the comma). 

2. Delimit fields (the blank). 

3. Perform syntactical functions. (For example, the appearance of && 
as the first two characters following DSNAME= tells the system that 
a temporary data set name follows. The appearance of / in the UNIT 
parameter, UNIT=293/5, tells the system that a specific 2321 bin is 
desired. ) 

Sometimes you can code a special character that does not satisfy one 
of the three uses of special characters. In most of these cases, you 
must indicate that special characters are being used by enclosing the 
item that contains the special characters in apostrophes (5-8 punch) , 
e.g., ACCT='123+U56* . If one of the special characters is an 
apostrophe, you must code two consecutive apostrophes (two 5-8 punches) 
in its place, e.g., 'O" •WEILL'. 

The following list contains those parameters that can have special 
characters as part of their variable information, and indicates when the 
apostrophes are not required. 

1. The accounting information on the JOB statement. The account 
number and additional accounting information can contain hyphens 
without being enclosed in apostrophes. 

2. The programmer's ncime on the JOB statement. The programmer's name 
can contain periods without being enclosed in apostrophes. 

3. The checkid field in the RESTART parameter on the JOB statement. 

U. The ACCT parameter on the EXEC statement. The ACCT parameter can 
contain hyphens without being enclosed in apostrophes. 

5. The FARM parameter on the EXEC statement. 

6. The DSNAME parameter on the DD statement. The DSNAME parameter can 
contain hyphens without being enclosed in apostrophes. If the 
DSNAME parameter contains a qualified name, it can contain periods 
without being enclosed in apostrophes. If the DD statement 
identifies a generation of a generation data group, the generation 
number in the DSNAME parameter can contain a plus or minus (hyphen) 
sign without being enclosed in apostrophes. If the DD statement 
defines a temporary data set, the DSNAME parameter can contain, as 
the first two characters, ampersands without being enclosed in 
apostrophes. If the DD statement defines a member of a partitioned 
data set, a generation of a generation data group, or an area of an 
indexed sequential data set, the DSNAME parameter contains 
parentheses that enclose the member name, generation niamber, or 
area name; these parentheses are not enclosed in apostrophes. 

7. The volume serial number in the VOLUME parameter on the DD 
statement. The volume serial niamber can contain hyphens without 
being enclosed in apostrophes. 



2IH JCL Reference 



Coding Form 



For your convenience in coding control statements, you can use Form 
N74167, a punch card containing formatted lines, each representing a 
different type of statement. (See Figure 3.) Some of the lines can he 
used for concatenations, overrides, and continuation statements. 




/ 


1 2 3 4 5 G 7 8 9 10 1112 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 


73 74 75 76 77 78 79 80 


■-> 


/ 


1 Z 
// 


3 Jobnome-Vor. 10 
1 1 1 1 1 1 1 




iS |4 

J|0|B 




'^ JOB Statement Operands 




lO/SEO 


u 
s 

/ 

3 




// 


3 Stepnome - 

1 1 1 


Vor 


1 




ElXlElC 




" EXEC Statement Operands 


00000000 


or 


/ / 


EiXjIlC 




^ EXEC Statement Operands 


10 







// 




"|"° 


1 1 1 1 




Did 




15 DD Statement Operands 


00000200 


J 


B 

c 


N 


or 


// 




Did 


7 ( ForConcoierotions) DD Statement Operands •■ , '" ,' 


00000300 


or 


/ / 


J 1 1 1 1 M 


" 


1 1 1 




1 1 




21 

DiD 




2'' DD Statement Operands (Ttiis statement foftnat % eofoteg*^ procedttr* <lverrt<t»» Or aiifelitions) 


00000400 




// 


3 


ROC fiame-Vor.Optional 

1 




PiRiOiC 




" PROC Statement Operands ' • ' ' - . , 


00000500 


T 
R 




/« 




■i Delimiter Statement Comments -' . /- ' " , 


00000600 


u 

L 




// 




4 Commond \arb-Var 




'3 Command Statement Operands ■ . . 


00000700 


s 

T 




// 


' <fi«ea) Blank Null Statement 


00000800 


A 

T 




/ / 


» 


1 Comment Statement Comments 


00000900 


t 

M 

E 
N 
T 

s 




// 


3 Continuation Statements ( For ail above except Delimiter, Command, Null, Comment Statements) 


W 


10 


N 



// 


3 
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Figure 3. Coding Form for Coding Control Statements 
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Section II: The JOB Statement 



The JOB statement marks the beginning of a job and, when jobs are 
stacked in the input stream, marks the end of the control statements for 
the preceding job. The JOB statement must contain a valid jobname in 
its name field. All parameters in its operand field are optional, 
unless your installation has established that the account number and the 
programmer's name parameters must be coded. If no parameters are coded 
in the operand field of the JOB statement, no comments can be coded on 
the statement. 




JOB Statement Format 

I //jobname JOB operands comments 



The JOB statement consists of the characters //, in columns 1 and 2, and 
four fields — the name, operation (JOB), operand, and comments fields. 



Rules for Coding 

Follow the order listed below when coding the JOB statement; 
1. Code the characters // in columns 1 and 2. 



I-IO 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 71-80 


I|2|3|4|5l6|7|8l9|0 


1 121314151-617181910 


l|2|3|4|5|6|7|8|9|0 


112i3|4|5|6|7|8|9l0 


||2|3|4|5|6|7|8|9|0 


l|2|3|4|5|6|7le|9|0 


1 |2|3|4i5l6|7i8|9|0 1 |2|3|4|5|6|7|8|9|0 





2. Select a name for the job; code that name, starting in column 3. 



i l-IO 11-20 21-30 ^l~^° '^j~5° 51-60 61-70 .71-80. 

|T.12|3|4|516|7|8|9|0| I |2|3|4|5l6l7l8l9lo| I |2|3|4|5|6|7|8|9|ol I I2|3l4|5|6|7l8l9|0| I |2|3l4|5|6|7|8l9lol I |2|3|4|5l6|7|8|9|o| I |2|3|4|5|6|7 |8 |9|0 1l | 2|3|4 |S|6|7|el9]0^ 



|/, / i C4 | /- | C , 



I I 1 I 



!''' ' ! 



I ' ' ' ' I 



.1 I . . I I I l_l-t.X-l.. ... L_i-.4.-X„X.,.l. J.^- 



3. Follow the jobname with at least one blank. 

4. Code JOB. 



I-IO 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 


.l|2|3|4|5|6|7|8|9|0 


I|2|3|4|5|6|718|9|0 


II2I3I4I5I6I7I8I910 


I|2l3|4|5i6|7|8l9l0 


II2I3I4I5I6I7I8I9I0 


II213I4I5I6I718I9I0 


Ii2|3|4|5|6|7i8l9l0 


Il2l3l4l5l6l7l8l9l0 


7/,C/l,i|C, ,J:0,^ 1 1 1 , , , , 1 , , , , 1 1 , , , , 1 , , , , 1 1 , , , , 



5. Follow JOB with at least one blank. 
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6. Code any desired positional parameters. Separate each parameter 
with a comma. 

. l7-~2o" " "T 21-30 f il-46 1 4i- 50 [ 51-60 . [ " , ^}~^9 , . . T , 71-80 

iciirsnasMMiiEliiiMiiiii^^ 



n2T3T4T5T6f7T8T9]0T 



7. code any desired keyword parameters. Separate each parameter with 
a comma . 



I-IO 



11-20 ^ 1 21-30 1 31-40 1 41-50 | 51-60 



2T3]4] 5T6r7TBl9rotT T2r 3T4T5l6r7T8r9l6 h[2 



61-70 



T 71-80 

pIjTzIsMsIIIzJ 



\IJMkiC,JM]^^LC^iJM^i/V^j.^JiMJ.£.i^£^ 



8. Code at least one blank. 

9. Code any desired comments. 



r i-16 73 ' li-20 T" ^ 21-30 T 31-40" •'! " 4 1- 50 ' I " 51-60 F 

I TT2 lf3]4 ISl eTTTsTgTorn 2I 3T4 r 5l6]7]8T9Td Trr2r3 r4T 5T6]7T8T9 1 1 1T2T3 T 4 1 5 1 6 1 7 1 8l9T0| TT2T3T4 TsT S 1 7 1 8 1 9 1 ] l 72]3 l4T5l[6l7lel 9]0T i 



n2r3r4T 5T6l7T8T9|0| lT2T3 T 4|5|6|7|8|9fO|TT2T3T4 T5T 6|7|8|9|or i 72]3l4T 5l[6l7^ I |2|3 |4|5|6|7|8|9|o| I |2|3|4 l5l6l7lel9lO 



\LlsCAL\C X0A\ ,j,',C,.l .hR.O^^\,AS>\(,L£M£\L-X.S.,\i)sj.R.e\61.0M-.\/.ofi.K, \d£.Prr..\ ,S.a. .f\ U.^, , , 



Positional and Keyword Parameters 

There are two types of parameters that can be coded on the JOB 
statement : 

Positional parameters , which must precede any keyword parameters and 
must be coded in the following order: 

accounting information (PCP, MFT, MVT) 
programmer's name (PCP, MFT, MVT) 

These positional parameters are described in the following pages in the 
order listed above. 

Keyword parameters , which may be coded in any order after the positional 
parameters . Any of the following keyword parameters can be coded on the 
JOB statesment: 

CLASS (MFT, MVT) 

COND (PCP, MFT, MVT) 

MSGCLASS (MFT, MVT) 

MSGI^VEL (PCP, MFT, MVT) 

PRTY (MFT, MVT) 

RD (PCP, MFT, MVT) 

REGION (MVT) 

RESTART (PCP, MFT, MVT) 

ROLL (MVT) 

TIM£; (MFT, MVT) 

TYPRUN (MFT, MVT) 

These keyword parameters are described, after the positional parameters,, 
in the order listed above. 

28 JCL Reference 



Sample JOB Statements 

1. //ALPHA JOB 8U3,LINLEE,CLASS=F,MSGLEVEL=(1,1) 

2. //LOS JOB ,BROWNLY,REGION=90K,TIME=(U,30),MSGLEVLL=(2,0) 

3. //MART JOB 1863,RESTART=STEP4 

4 . //TRY8 JOB 
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Assigning a Jobname 

I //jobnarne JOB 



You must assign a name to every job submitted for execution. The 
jobname must begin in column 3 of the JOB statement and must consist of 
1 through 8 alphameric and national (#, 3, $) characters. The first 
character must be an alphabetic or national character. 

No two jobs in a multiprogramming environment should have the same 
jobname . 

The following names and characters should not be used as jobnames, 
because they are keywords of the DISPLAY command: 

CONSOLES A 

DSNAME N 

JOB NAMES Q 

SPACE R 

STATUS T 

If you must assign one of these keywords as a jobname, notify the 
operator, so he will be sure to enclose the jobname in parentheses when 
he uses it with the DISPLAY command. For example, if you have assigned 
the jobname SPACE to a job and the system operator wishes to display the 
status of the job, he must issue a command stating DISPLAY (SPACE) . If 
the parentheses were omitted, the operator would get the amount of 
available space on a particular direct access volume resulting from a 
DISPLAY SPACE command. 



Examples of Valid Jobname s 




//RERUN4 


JOB 


//#123A 


JOB 


//JOED 5 8 


JOB 
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Accounting Information Parameter (For PGP, MFT, MVT) 

([account niMnberj [, additional accounting inforrration, . . , ] ) 



account number 

the account number to which this job is to be charged. 

additional accounting information 

any other accounting information required by an installation's 
accounting routines. When additional accounting information 
consists of more than one item, each must be separated by a comma. 



Rules for Coding 

1. when accounting information is supplied, it must be coded before 
any other parameter on the JOB statement. 

2. The account number and each item of additional accounting 
information are considered subparameters and each must be separated 
by a comma . 

3. When accounting information consists of more than one subparameter , 
you must enclose the information in either parentheses or 
apostrophes (5-8 punch), e.g., ' 5a38,GROUP6' or (5438,GROUP6) . 

4. If the accounting information must be continued on another 
statement, enclose the accounting information in parentheses. You 
may not continue on anothe-r statement any accounting information 
enclosed in apostrophes. 

5. The account number and other accounting information cannot exceed 
142 characters, including the comimas that separate the 
subparameters . 

6. If any of the subparameters contain special characters (except 
hyphens) , either: (1) enclose the accounting information in 
apostrophes, or (2) enclose the subparameter in apostrophes and the 
accounting information in parentheses, e.g., '543 8,10/08/66' or 
(5438, '10/08/66') . (The enclosing apostrophes are not considered 
part of the information.) If one of the special characters is an 
apostrophe, code two consecutive apostrophes in its place, e.g., 
(5438, 'O' 'NEILL') . If one of the special characters is an 
ampersand and you are not defining a symbolic parameter, code two 
consecutive ampersands in its place, e.g., '34&S8241'. 

7. If you do not supply accounting informiation but do code the 
programmer's name, you must code a commia preceding tne programmer's 
name to indicate that the accounting information parameter, which 
is a positional parameter, has been omitted. 



Supplying Accounting Information 

Accounting information is optional unless the installation establishes 
it as a requirement in (1) a system generation option in PCP, or (2) a 
FARM field param.eter of the cataloged procedure for the input reader in 

MFT and MVT. 

Section II: The JOB Statement — Accounting Inform.ation Parameter 33 




Routines that process accounting information must be supplied by the 
installation. For information on how to add accounting facilities, 
refer to the chapter "Handling Accounting Information" in the System 
Programmer ' s Guide publication. 



Examples o£ the Accounting Information Parameter 

1. //JOB43 JOB D548-8 68 

Account number only; no parentheses are reguired. 

2. //J0B4U JOB (D548-868, '12/8/69' , WILSON) 

Account number plus additional accounting information; parentheses 
are required. 

3. //JOB 4 5 JOB (,E1659,GR0UP6X) 

Only additional accounting information; parentheses are required. 
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Programmer's Name Parameter (For POP, MFT, MVT) 

programmer * s name 

programmer ' s name 

the name or identification of the person responsible for the job. 



Rules for Coding 

1. If the programmer's name parameter is coded, it must follow the 
accounting information parameter, or the comma that indicates its 
absence, and must precede all keyword parameters. 

2. The name cannot exceed 20 characters, including all special 
characters , 

3. If the name contains special characters, other than periods, 
enclose the name in apostrophes . If the special characters include 
apostrophes, each must be shown as two consecutive apostrophes. 

4. If you are not required to specify a name, you need not code a 
comma to indicate its absence. 



When to Code the Programmer's Name Parameter 

The programmers' name parameter is optional unless the installation 

establishes it as a requirement in (1) a system generation option in 

PCP, or (2) a PARM field parameter of the cataloged procedure for the 
input reader in MFT and MVT. 



Examples o£ the Programmer's Name Parameter 

1. //APP JOB ,C. L.BROWN 

Programmer's name, without accounting information supplied. 

2. //DELTA JOB ,'T.O"NEILL' 

Programmer's name containing special characters, without accounting 
information supplied. 

3. //#308 JOB (8U63U9,GROUP12), GREGORY 

Account number plus additional accounting information and 
programmer's name. 
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The CLASS Parameter (For MFT, MVT) 

CLASS= jobclass 

jobclass 

assigns a job class to your job. Code any alphabetic character 
from A through O, depending on the characteristics of your job and 
the installation's rules for assigning a job class. 



Rules for Coding 

1. If the CLASS parameter is coded for PCP, the parameter is not used, 
but is checked for syntax. 



Assigning a Job Class to Your Job 

The CLASS keyword parameter provides a way of establishing a good mix of 
jobs in the system; an example of a good mix would be one job that is 
I/O bound in the system with another job that is CPU bound. A good mix 
can be established since the job class determines where a job will be 
placed on the input work queue and jobs with common characteristics are 
assigned to the same job class. Jobs within a job class are assigned a 
priority, either in the PRTY parameter or by default. This allows jobs 
within a class to be selected for processing based on their priorities. 

If you. do not specify the CLASS parameter, the default job class of A 
is assigned to the job. 

THE CLASS PARAMETER AND TIME- SLICING 

If your installation provides time-slicing facilities with MFT, the 
CLASS parameter can be used to make a job part of a group of jobs to be 
time-sliced. At system generation, a group of contiguous partitions are 
selected to be used for time-slicing, and each partition is assigned at 
least one job class. To make your job part of a group of jobs to be 
time-sliced, specify a class that was assigned only to the partitions 
selected for time-slicing. (With MVT, you use the PRTY parameter and 
the DPRTY parameter to make, respectively, a job or job step part of a 
group of jobs and job steps to be time-sliced.) 



Examples of the CLASS Parameter 

1. //SETUP JOB CLASS=C 
Assigning a job to job class C. 

2. //JAN JOB CLASS=M,PRTY=10 

Assigning a job to job cliiss M with a priority of 10. 
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The COND Parameter (For POP, MFT, MVT) 

COND= ( ( code , operator ),...) 

code 

a decimal number from through 4095. This number is compared with 

the return code issued by each job step. ^^^BS 

operator 

the type of comparison to be made with the return code. Relational 
operators and their meanings are: 

GT... greater than 

GE... greater than or equal to 

EQ. . .equal to 

LT. . .less than 

LE.,.less than equal to 

NE...not equal to 



Rules £or Coding 

1. Code from one through eight different return code tests. 

2. When making only one return code test, you need not code the outer 
parentheses. 



Using the COND Parameter 

The COND keyword parameter can be used to eliminate unnecessary use of 
computing time by basing the continuation of a job on the successful 
completion of one or more of its job steps. The operator in the COND 
parameter indicates the mathematical relationship between the code 
specified on the JOB statement and the code returned by a completed job 
step. The operator or operators are compared with the return code and 
if any of the relationships are true, the remaining steps are bypassed 
and the job is terminated. Up to eight different tests, each consisting 
of a code and operator, may be specified. 

The compiler, assembler, and linkage editor programs issue return 
codes. You may want to use the COND parameter to test these return 
codes . If you write your processing programs in assembler language or 
PL/I, you can use the COND parameter to test return codes issued by your 
programs . 

WHEN THE COND PARAMETER IS CODED ON BOTH THE JOB AND EXEC STATEMENTS 

The COND parameter can also be coded on an EXEC statement. When a 
return code test requested on an EXEC statement is satisfied, the 
associated job step is bypassed. 

If you code the COND parameter on the JOB statement and on one or 
more of the job's EXEC statements, the return code tests requested on 
the JOB statement have precedence over those requested on the EXEC 
statements. Therefore, any return code test requested on the JOB 
statement that is satisfied causes termination of the job, even if the 
return code test is not satisfied for a particular step. 
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Examples of the COND Parameter 

1, //TYPE JOB C0ND=(7,LT) 

If 7 is less than the return code, the job is terminated. (Any 
ret\3rn code less than 7 allows the job to continue.) 

2. //TEST JOB COND=((20,GE), (30,LT)) 

If 20 is greater than or equal to the return code, or 30 is less 
than the return code, the job is terminated. (Any return code of 21 
through 30 allows the job to continue.) 



40 JCL Reference 



The MSGCLASS Parameter (For MFT, MVT) 

MSGCLASS=OUtput class 

output Class 

the output class to which systern messages for your job are to be 
routed by the .system. Code an alphabetic (A-Z) or numeric (0-9) 
character depending on your installation's rules for assigning an 
output class for system messages. 



Rules for Coding 

1. If the MSGCLASS parameter is coded for PCP, the parameter is not 
used, but is checked for syntax. 



Assigning an Output Class to System Messages 

If the MSGCLASS parameter is not coded, system messages associated with 
your job are routed to the default output class specified in the FARM 
field of the input reader procedure. The default for the MSGCLASS 
parameter is A unless changed by your installation. You can consult the 
System Programmer's Guide for information concerning the input reader 
procedure. Your installation may require that you specify a different 
output class other than the default value in order to separate different 
types of output or to distribute the workload of the output writers. 
One or more output classes is associated with each output writer; each 
output writer is associated with a specific output device. 

You can route a job's system messages and output data sets to the 
same output class. You do this by coding the same output class in both 
the MSGCLASS parameter on the JOB statement and the SYSOUT parameter on 
the DD statements for the data sets. 



Examples of the MSGCLASS Parameter 

1. //IN JOB MSGCLASS=F 
Specifying an output class. 

2 . //BOTLE JOB 

Specifying no output class. In this case, the output class will 
default to the MSGCLASS value specified in the FARM field of the 
input reader procedure. The default is A unless changed by your 
installation . 

3. 




//A1430 


JOB 


MSGCLASS=L 


//STEPl 


EXEC 


PGM=PRINT 


//OUTPUT 


DD 


SYSOUT=L 



Specifying that a job's system messages (MSGCLASS parameter) and 
output data set (SYSOUT parameter) are to be routed to the same 
output class . 
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The MSGLEVEL Parameter (For PGP, MFT, MVT) 

MSGLEVEL= (statements , messages) 

statements 

specifies which job control statements are to be written as 
output from your job. Code: 

- when only the JOB statement is to be written. 

1 - when all input job control statements, cataloged 

procedure statements , and the internal representation of 
procedure statement parameters after symbolic parameter 
substitution are to be written. 

2 - when only input job control statements are to be written. 

messages 

specifies what allocation/termination messages (consisting of 
allocation, disposition, and allocation recovery messages) are 
to be written as output from your job. Code: 

- when no allocation/termination messages are to be 

written, unless the job abnormally terminates. If this 
occurs, these messages are to be written as output. 

1 - when all allocation/termination messages are to be 

written. 



Rules for Coding 

1. If the first subparameter of the MSGLEVEL parameter is omitted, you 
must code a comma to indicate its absence, e.g., MSGLEVEL= ( , 1) . 

2. If the second subparcimeter of the MSGLEVEL parameter is omitted, 
you need not code the parentheses, e.g., MSGLEVEL=2. 

Requesting Output of Job Control Statements 
and Certain Messages 

The MSGLEVEL keyword parameter is used to tell the job scheduler what 
output from your job is to be written as part of the output listing. 
You can request the following output: 

• The JOB statement. 

• All input job control statements. 

• All cataloged procedure statements for procedures called by any of 
the job's steps and the internal representation of procedure 
statement parameters after symbolic parameter substitution. 

• Allocation, disposition, and allocation recovery messages 
(allocation/termination messages) . 

You need to code the MSGLEVEL parameter only when the established 
default will not provide you with the desired output. In PCP, the 
default is established during system generation. In MFT and MVT , the 
default is established as a PARM parameter field in the cataloged 
procedure for the input reader. The established default is assiomed when 
MSGLEVEL is not coded or when one of the subparameters is not coded. 
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Examples o£ the MSGLEVEL Parameter 

1. //GD40 JOB MSGLEVEL=(2,1) 

Requesting tnat only input statements and all allocation/termination 
messages be written. 

2. //STEL JOB MSGLEVEL= ( , 1) 

Requesting that only the JOB statement and all 
allocation/termination messages be \f*ritten. 

3. //SYM JOB MSGLEVEL=(1,0) 

Requesting that all input control statements, procedure statements, 
the internal representation of procedure statements after symbolic 
parameter substitution, and no allocation/termination messages be 
written. 
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The PRTY Parameter (For MFT, MVT) 

PRTY=priority 

priority 

assigns a priority of through 13 to your job. (The highest 
priority is 13.) 

Rules for Coding 

1. Avoid using priority 13 since this priority is used by the system 
to expedite processing of jobs in which certain errors were 
diagnosed. 

2. In MVT, if you want a job step to have a different dispatching 
priority than the job's, code the DPRTY parameter on the EXEC 
statement associated with that job step. 

3. If the PRTY parameter is coded for PCP, the parameter is not used, 
but is checked for syntax. 



What the PRTY Parameter Does 

The PRTY keyword parameter determines the job's initiation priority 
within its job class. (The job class is assigned in the CLASS parameter 
on the JOB statement.) When the job is initiated, the system converts 
the job's priority into a dispatching priority so that the job's tasks 
can compete with other tasks for use of main storage and CPU resources. 

If you do not specify the PRTY parameter, a default priority is 
assumed. The default is specified as a PARM parameter field in the 
cataloged procedure for the input reader. 

THE PRTY PARAMETER AND TIME-SLICING 

If your installation provides time-slicing facilities in MVT, the PRTY 
parameter can be used to make a job part of a group of jobs and job 
steps to be time-sliced. The priorities of the time-sliced groups are 
selected at system generation. To make your job part of a group of jobs 
to be time-sliced, specify a priority number selected for time-slicing. 
(To make one of the job's steps part of a group of jobs and job steps to 
be time-sliced, code the DPRTY parameter on the associated EXEC 
statement . ) 



Examples of the PRTY Parameter 

1. //#1930 JOB PRTY=8,CLASS=C 

The job will have an initiation priority of 8 in the job class C. 

2. //RING JOB PRTY=U 

The job will have an initiation priority of U in the job class A. 
(Since the CLASS parameter is not specified, the job is assigned to 
the default job class A.) 
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The RD Parameter (For POP, MFT, MVT) 



RNC 



NC 



NR 



rd=Ir 

I RNC I 

NC 

'nr 



specifies that automatic step restart is permitted. 

specifies that automatic step restart is permitted and automatic 
checkpoint restart is not permitted and no checkpoints can be 
established. 



specifies that neither automatic step restart nor automatic 
checkpoint restart is permitted and no checkpoints can be 
established. 



specifies that neither automatic step restart nor automatic 
checkpoint restart is permitted, but the CHKPT macro instruction 
can establish a checkpoint. 



Rules for Coding 

1. Be sure to code MSGLEVEL=(1,0) , MSGLEVEL=(1 , 1) , or MSGLEVEL=1 in 
MFT and MVT when RD=R or RD=RNC is specified. 

2. If you are permitting automatic step restart, assign each step a 
unique step name. 

3. Code the RD parameter on EXEC statements, instead of the JOB 
statement, when you want to make different restart requests for 
each job step. (If the RD parameter is coded on the JOB statement, 
RD parameter^ coded on the job's EXEC statements are ignored.) 



Using the Restart Facilities 

The RD (restart definition) keyword parameter is coded when you want to 
make use of the step restart facilities, to suppress the action ojE the 
CHKPT macro instruction, or to suppress automatic restarts. The step 
restart facilities permit execution of a job to be automatically 
restarted at a job step after the job abnormally terminates, or, in MFT 
and MVT, after a system failure occurs. Through the RD parameter, you 
can specify that execution of a job is to be automatically restarted at 
the beginning of a job step that abnormally terminates (step restart). 

Execution of a job can also be automatically restarted within a job 
step that abnormally terminates (checkpoint restart) . In order for 
checkpoint restart to occur, the CHKPT macro instruction must have been 
executed in the processing program before abnormal termination. When 
you use the RD parameter to request suppression of CHKPT macro 
instruction action, automatic checkpoint restart cannot occur. 
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If the RD parameter is not coded, step restart cannot occur. If the 
RD parameter is not coded and the processing programs contain CHKPT 
macro instructions, checkpoint restart can occur. 

The following two conditions must be met before automatic step or 
checkpoint restart can occur: (1) the completion code returned during 
abnormal termination indicates that the step is eligible for restart, 
and (2) the operator authorizes restart. In addition, for automatic 
restart to occur in MFT or MVT, MSGLEVEL= ( 1 , ) , MSGLEVEL= (1 , 1) , or 
MSGLEVEL=1 must be coded on the JOB statement. If these conditions are 
satisfied, special disposition processing is performed before restart. 
If automatic step restart is to occur, all data sets in the restart step 
with a status of OLD or MOD, and all data sets being passed to steps 
following the restart step, are kept. All data sets in the restart step 
with a status of NEW are deleted. If automatic checkpoint restart is to 
occur, all data sets currently in use by the job are kept. 



DEFINING RESTART 

You define the type of restart that can occur by coding one of the 
subparameters of the RD parameter: R, RNC, NC, or NR. Each of these 
subparameters is described in detail in the following paragraphs. 

RD=R ; R indicates that automatic step restart is permitted. If the 
job's processing programs do not include any CHKPT macro instructions, 
coding RD=R permits execution to be resumed at the beginning of any step 
that abnormally terminates. If any program does include a CHKPT macro 
instruction, coding RD=R permits step restart to occur only if the step 
abnormally terminates before execution of the CHKPT macro instruction; 
thereafter, only checkpoint restart can occur. If you cancel the 
effects of the CHKPT macro instruction before a checkpoint restart is 
performed, the request for automatic step restart is again in effect. 

RD=RNC ; RNC indicates that automatic step restart is permitted and 
automatic checkpoint restart is not permitted. RD=RNC should be 
specified when you want to suppress the action of all CHKPT macro 
instructions included in the job's processing programs and to permit 
automatic step restart. 

RD=NC ; NC indicates that neither automatic step restart nor automatic 
checkpoint restart is permitted. RD=NC should be specified when you 
want to suppress the action of all CHKPT macro instructions included in 
the job's processing programs and not to permit automatic step restart. 
RD=NC has no effect on processing if CHKPT macro instructions are not 
included in the progrcims. 

RD=NR ; NR indicates that a CHKPT macro instruction can establish a , 
checkpoint, but neither automatic step restart nor automatic checkpoint 
restart is permitted. Coding RD=NR allows you to resubmit the job at a 
later time and specify in the RESTART parameter the checkpoint at which 
execution is to be resumed. (The RESTART parameter is coded on the JOB 
statement of the resubmitted job.) RD=NR has no effect on processing if 
CHKPT macro instructions are not included in the job's processing 
programs . 

Reference s 

1. For detailed information on the checkpoint/restart facilities, 
refer to the publication Advanced Checkpoint/Restart Planning 
Guide , GC28-6708> the topic "Checkpoint and Restart" in the 
publication Supervisor and Data Management Services ; and "Using 
the Restart Facilities" in Appendix B of this publication. 
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2. For information on how to code the CHKFT macro instruction, refer 
to the publication Supervisor and Data Management Macro 
Instructions . 



Examples of the RD Parameter 

1. //MAY JOB RD=R,MSGLEVEL=(1,0) 

Permits execution to be automatically restarted with the step that 
abnormally terminates. 

2. //TRY 5 6 JOB RD=RNC , MSGLEVEL= (1 , 1) 

Permits execution to be automatically restarted beginning with the 
step that abnormally terminates and suppresses the action of CHKPT 
macro instructions. 

3. //PASS JOB RD=NR,MSGLEVEL=(1,1) 

Neither automatic step nor checkpoint restart can occur, but CHKPT 
macro instructions can establish checkpoints . 
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The REGION Parameter-Without Main Storage Hierarchy Support 
(For MVT) 

REGION=valueK 

valueK 

specifies the number of contiguous 1024-byte areas of main storage 

to be allocated to each job step. The mrniber can range from one to ^^^EQI^ 

five digits but may not exceed 16383. 



Rules for Coding 

1. Code an even number. (If you code an odd number, the system treats 
it as the next highest even number. When the value 16383K is 
coded, the system treats it as 1638UK. However, the value 1638UK 
must not be coded on the JOB statement . ) 

2. Code the REGION parameter on EXEC stcitements, instead of the JOB 
statement, when you want to specify a. different region size for 
each job step. (If the REGION parameter is coded on the JOB 
statement, REGION parameters coded on the job's EXEC statements are 
ignored. ) 

3. If the REGION parameter is coded for PCP or MET, the parameter is 
not used, but is checked for syntax. 



Requesting Main Storage 

The REGION keyword parameter is used to specify how much main storage, 
in contiguous bytes, is to be allocated to each job step. Code the 
REGION parameter when you want more storage or less storage than would 
be allocated if the default region size was used. The default region 
size is established as a FARM parameter field in the cataloged procedure 
for the input reader. You can consult the Storage Estimates publication 
to help you determine how much main storage is required to process your 
job. 



ACQUIRING ADDITIONAL MAIN STORAGE 

If any of the job's steps may require use of more storage than has been 
allocated, you can code the ROLL parameter and request that the system 
try to provide you with additional main storage. The ROLL parameter is 
described in the chapters "The ROLL Parameter" later in this section and 
in Section III. 



Examples of the REGION Paranieter 

1. //COLE JOB REGI0N=112K 

Specifies that 112 contiguous 1 02 U- byte areas of main storage are to 
be allocated to each job step. 
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2. //J3a JOB REGION=70K,ROLL=(YES,YES) 

The REGION parameter specifies that 70 contiguous ,1024-byte areas of 
main storage are to be allocated to each job step. In the ROLL 
parameter, the first subparcimeter tells the system that any of the 
job's steps may be rolled out if additional storage is required by 
another job; the second subparameter tells the system that it should 
try to provide you with additional main storage if it is required. 
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The REGION Parameter-With Main Storage Hierarchy Support 
(For MVT. Excluding MBBMP) 

REGI01SI= ( valueo K , value^K) 

valueoK 

specifies the number of contiguous 102 4-byte areas in hierarchy 
to be allocated to each job step. If IBM 2361 Core Storage is 
present, the nxiinber cannot exceed 16383. 

value^K 

specifies the number of contiguous 1024-bYte areas in hierarchy 1 
to be allocated to each job step. If IBM 2361 Core Storage is 
present, the number cannot exceed 102U (for each Model 1) or 2048 
(for each Model 2) . 



Rules for Coding 

1. when processor storage includes hierarchies and 1, the sum of 
valueo ^"cl value^ cannot exceed 16383. 

2. Code even numbers. (If you code an odd number, the system treats 
it as the next highest even number. When 16383K is coded for 
valueo, the system treats it as 16384K. However, 1638UK must not 
be coded for valueo^ on the JOB statement.) 

3. when you are requesting storage only in hierarchy 1, precede value^ 
with a comma, to indicate the absence of valueo. 

4. Wheii you are requesting storage only in hierarchy 0, you need not 
code the parentheses. 

5. Code the REGION parameter on EXEC statements, instead of the JOB 
statement, when you want to specify a different region size for 
each job step. (If the REGION parsimeter is coded on the JOB 
statement, REGION parameters coded on the job's EXEC statements are 
ignored. ) 

6. If the REGION parameter is coded for PCP or MET, the parameter is 
not used, but is checked for syntax. 



Requesting Main Storage in One or Two Hierarchies 

The REGION keyword parameter is used to specify how much main storage is 
to be allocated to each job step, and, when main storage hierarchy 
support has been specified at system generation, in which hierarchy or 
hierarchies main storage is to be allocated. With main storage 
hierarchy support, storage hierarchies and 1 are provided. If IBM 
2361 Core Storage, Model 1 or 2, is present in the system, processor 
storage is referred to as hierarchy and 2361 Core Storage is referred 
to as hierarchy 1. If 2361 Core Storage is not present, a two-part 
region is established in processor storage when regions are requested in 
two hierarchies. The two parts are not necessarily contiguous. 
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Code t:he REGION parameter to specify how much storage is to be 
allocated in each hierarchy, or that all storage for the job is to be 
allocated in a particular hierarchy, (If you do not code the REGION 
parameter on either the JOB or EXEC statement, the default region size, 
which is a PARM parameter field in the cataloged procedure for the input 
reader, is used and is always allocated in hierarchy 0. If you code the 
REGION parameter and request storage only from hierarchy 1, no hierarchy 
segment will be allocated. You can consult the Storage Estimates 
publication to help you determine how much main storage is required to 
process your job. Then, depending on your reasons for using 
hierarchies, determine how much storage is required in each. 

If maiji storage hierarchy support was not specified at system 
generation and regions are requested in both hierarchies, the region 
sizes are combined and an attempt is made to allocate a single region 
from processor storage. If a region is requested entirely from 
hierarchy 1, an attempt is made to allocate the region from processor 
storage. 

ACQUIRING ADDITIONAL MAIN STORAGE 

If your job may require use of more main storage than has been allocated 
in a particular hierarchy, you can code the ROLL parameter and request 
that the system try to provide you with additional main storage in that 
hierarchy. The ROLL parameter is described in the chapters "The ROLL 
Parameter" later in this section and in Section III. 



Examples of the REGION Parameter 

1, //MAIN JOB REGION=(80K,30K) 

Specifies that the system is to allocate 8 contiguous 102U-byte 
areas of storage in hierarchy and 30 contiguous 102U-byte areas of 
storage in hierarchy 1. If main storage hierarchy support is not 
included in the system, the system will try to obtain 110 contiguous 
102U-byte areas in processor storage. 

2, //WEEK JOB REGION=(,98K) 

Specifies that the system is to allocate 98 contiguous 1024-byte 
areas of storage in hierarchy 1. 

3. //JWC JOB REGION=98K 

Specifies that the system is to allocate 98 contiguous 1024-byte 
areas of storage in hierarchy 0. 

4. //TEST12 JOB REGION=(100K,50K) ,ROLL={YES,YES) 

The REGION parameter specifies that the system, is to allocate 100 
contiguous 1024-byte areas of storage in hierarchy and 50 
contiguous 102U-byte areas of storage in hierarcny 1. In the ROLL 
parameter, the first subparameter tells the system that any of the 
job's steps may be rolled out if additional storage is required Joy 
another job; the second subparameter tells the system that it should 
try to provide you with additional main storage if it is required. 
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The RESTART Parameter (For POP. MFT, MVT) 

RESTART= ( ( * J [ , checkid ] ) 

\ stepname > 

(. stepname . procstepname) 



indicates that execution is to be restarted at or within the first 
job step. 

stepname 

specifies that execution is to be restarted at or vzithin the named 
job step. 

stepname. procstepname 

specifies that execution is to be restarted at or within a 
cataloged procedure step. Stepname is the name of the job step 
that calls the cataloged procedure, and procstepname is the name of 
the procedure step. Yoti can code ♦ in place of 
stepname. procstepname if the first job step calls a cataloged 
procedure and you want execution to be restarted at or within the 
first procedure step. 

checkid 

is the name of the checkpoint at which execution is to be 
restarted. When checkid is coded, execution is restarted within 
the specified job step at the named checkpoint. If checkid is not 
coded, execution is restarted at the specified job step. 



Rules for Coding 

1. You need not code the parentheses if execution is to be restarted 
at a job step, i.e., if you do not code the checkid subparameter. 

2. If the checkpoint name contains special characters, the name must 
be enclosed in apostrophes. If one of the special characters is an 
apostrophe, identify it by coding two consecutive apostrophes in 
its place. 

3. Be sure to include the SYSCHK DD statement when execution is to be 
restarted within a job step. (The SYSCHK DD statement is described 
in the chapter "Assigning a Ddname" in S«=ction IV of this 
publication. ) 



When to Code the RESTART Parameter 

The RESTART keyword parameter is coded when you are resubmitting a job 
for execution and you want to make use of the restart facilities. The 
restart facilities allow a job that is resubmitted for execution to be 
restarted at or within a particular job step. This reduces the time 
required to execute the job since execution is resumed, not repeated. 
If the RESTART parameter is not coded, execution of the entire job is 
repeated. 

Through the RESTART parameter, you can specify where execution is to 
be restarted. Execution of a resubmitted job can be restarted at the 
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beginning of a step (step restart) or within a step (checkpoint 
restart) . In order for checkpoint restart to occur, the CHKPT macro 
instruction must have been executed in the processing program during the 
original execution of the job. If execution is to be restarted at a 
checkpoint, the resubmitted job must include an additional DD statement. 
This DD statement defines the checkpoint data set and has the ddname 
SYSCHK . (For additional information on the SYSCHK DD statement, see the 
chapter "Assigning a Ddname" in Section IV of this publication.) 



RULES FOR REFERENCING GENERATION DATA SETS AND USING BACKWARD REFERENCES 

Because the resubmitted job has been previously executed and because you 
may not be restarting with the first job step, there are certain rules 
that apply to referencing generation data sets and using backward 
references. They are: 

1. If step restart is performed, generation data sets that were 
created and cataloged in steps preceding the restart step must not 
be referred to in the restart step or in steps following the 
restart step by means of the same relative generation numbers that 
were used to create them. Instead, you must refer to a generation 
data set by means of its present relative generation number. For 
example, if the last generation data set created and cataloged was 
assigned a generation number of +2, it would be referred to as in 
the restart step and in steps following the restart step. In this 
case, the generation data set assigned a generation number of +1 
would be referred to as -1. If generation data sets created in the 
restart step were kept instead of cataloged (i.e., 

DISP= (NEW, CATLG, KEEP) was coded), you can during checkpoint restart 
refer to these data sets and generation data sets created and 
cataloged in steps preceding the restart step by the same relative 
generation numbers used to create them. 

2. Before resubmitting a job, check all backward references to steps 
that precede the restart step. Eliminate all backward references 
for the following keywords: PGM and COND, on the EXEC statements, 
and, SUBALLOC and VOLUME=REF=reference, on the DD statements. (A 
backward reference of VOLUME=REF=ref erence is allowed if the 
referenced statement includes VOLUME=SER= (serial number,...).) 

Referenc e 

1. For detailed information on the checkpoint/restart facilities, 
refer to the publication Advanced Checkpoint/Restart Planning 
Guide , the topic "Checkpoint and Restart" in the publication 
Supervisor and Data Management Services , and "Using the Restart 
Facilities" in Appendix B of this publication. 



Examples of the RESTART Parameter 

1. //LINES JOB RESTART=COUNT 

Specifies that execution is to be restarted at the job step named 
COUNT. 

2. //aL0C5 JOB RESTART=( PROCESS, CHKPT3) 

Specifies that execution is to be restarted within the job step 
named PROCESS at the checkpoint named CHKPT3. This JOB statement 
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must be followed by a DD statement named SYSCHK, which defines the 
data set on which an entry for the checkpoint named CHKPT3 was 
written. 

3. //WORK JOB RESTART=(*,CKPT2) 

Specifies that execution is to be restarted at the checkpoint named 
CKPT2 in the first job step. 

W=i 

//CLIP5 JOB RESTART=( PAY. WEEKLY, CHECKS) 

Specifies that execution is to be restarted within the procedure 
step named WEEKLY at the checkpoint named CHECKS. PAY is the name 
of the job step that calls the cataloged procedure that contains the 
procedure step named WEEKLY. This JOB statement roust be followed by 
a DD statement named SYSCHK, which defines the data set on which an 
entry for the checkpoint named CHECKS was written. 
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The ROLL Parameter (For MVT) 

ROLL=(x,y) 



declares whether the steps of the job may be rolled out. Code YES 
if the job's steps can be rolled outj code NC if the job's steps 
cannot be rolled out. 

declares whether the steps of the job may cause rollout of another 
job step. Code YES if the job's steps can cause rollout of another 
job step; code NO if the job's steps cannot cause rollout of 
another job step. YES must be coded if you want additional main 
storage allocated to the job's steps when additional main storage 
is required. 



Rules for Coding 

1. If you code the ROLL parameter, both subparameters must be 
specified. 

2. Code the ROLL parameter on EXEC statements, instead of the JOB 
statement, when you want to make different requests for each job 
step. (If the ROLL parameter is coded on the JOB statement, ROLL 
parameters coded on the job's EXEC statements are ignored.) 

3. Code ROLL=(NO,YES) or ROLL=(NO,NO) if this job is a teleprocessing 
job that uses the Auto Poll option. If you allow the job's steps 
to be rolled out, the job cannot be restarted properly. 

4. If the ROLL parameter is coded for PCP or MET, the parameter is not 
used, but is checked for syntax. 



When to Code the ROLL Parameter 

The ROLL keyword parameter should be coded if any of the job's steps may 
require more main storage than was requested in the REGION parameter. 
When you specify in the ROLL parameter that this job can cause rollout 
of other job steps, an attempt is made to allocate additional storage if 
a job step requires it. In order to allocate this additional space to a 
job step, another job step with a lower priority may have to be rolled 
out, i.e., temporarily transferred to secondary storage. 

The ROLL parameter should also be coded when you want control over 
whether the job's steps can be rolled out because of another step's need 
for additional main storage. If the ROLL parameter is not coded, the 
default established in the PARM parameter field in the cataloged 
procedure for the input reader is used. 




ira 
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Examples of the ROLL Parameter 

1. //DIMTER JOB ROLL=(YES,YES),REGION=100K 

Specifies that the job's steps can be rolled out and can cause 
rollout of another job step if a step requires more than lOOK of 
main storage. 

2, //TEST332 JOB ROLL= (NO, YES) 

Specifies that the job's steps cannot be rolled out but can cause 
rollout of another job step. 
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I The TIME Parameter (For MFT, MVT) 



TIME=j Crninutes, seconds 
J1440 



1 




minutes 

specifies the maximum number of minutes the job can use the CPU. 

The number of minutes must be less than muO (24 hours). ^^BISIS 

seconds 

specifies the maximum number of seconds beyond tne specified number 
of minutes the job can use the CPU, or, if no minutes are 
specified, the maximum number of seconds the job can use the CPU. 
The number of seconds must be less than 60. 

1440 

specifies that the job is not to be timed, code 1440 if the job 
may require use of the CPU for 24 hours or more or if any of the 
job's steps should be allowed to remain in a wait state for more 
than the established time limit. 



Rules for Coding 

1. If the CPU time limit is given in minutes only, you need not code 
the parentheses . 

2. If the CPU time limit is given in seconds only, you must code a 
comma preceding the seconds to indicate the absence of minutes. 

3. You can also code the TIME parameter on EXEC statements to indicate 
how long each step can use the CPU. 

4. If the TIME parameter is coded for PCP, the parameter is not used, 
but is checked for syntax. 



Specifying a Time Limit for the Job 

The TIME keyword parameter can be used to specify the maximum amount of 
time a job may use the CPU. Two benefits of coding the TIME parameter 
are that it allows you to find out how long the job uses the CPU (CPU 
time used appears on the output listing) , and it helps limit the CPU 
time wasted by a step that goes into a loop. Normally, a job that 
exceeds the specified time limit is terminated. However, if the System 
Management Facilities option is included in the system and a user exit 
routine is provided, this routine can extend the time limit so that 
processing can continue. When the TIME parameter is not coded on the 
JOB statement, there is no CPU time limit assigned to the job; however, 
each job step is still timed. 

TIME LIMIT FOR WAIT STATES 

Since a job step can go into an extremely long wait state, the time a 
job step may remain in a wait state is limited. If the System 
Management Facilities option is included in the system, the installation 
determines this time limit. In this case, a job step remaining in a 
wait state for more than the established time limit causes termination 
of the job unless a user-provided exit routine extends the wait-state 
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time limit for that step. If the System Management Facilities option is 
not included, the system automatically provides a 30-minute time limit 
for wait states; a job step remaining in a wait state for more than 30 
consecutive minutes causes termination of the job. 



How to Eliminate Timing 

Certain applications require a job to use the CPU for 24 hours or more., 
In this case you must eliminate timing by coding TIME=1440. This 
specification should also be made when any of the job's steps should be 
allowed to remain in a wait state for more than the established time 
limit. 



Referenc e 

1. A discussion of the System Management Facilities option is 
contained in "Section 5: Task Management" in Concepts and 
Facilities . Information on user exit routines to be used with th€J 
System Management Facilities option is contained in the chapter 
"System Management Facilities" in System Programmer's Guide . 



Examples of the TIME Parameter 

1. //SEED JOB TIME=(12,10) 

Specifies that the maximum amount of time the job can use the CPU is 
12 minutes 10 seconds. 

2. //TYPEUl JOB TIME=(,30) 

Specifies that the maximum amount of time the job can use the CPU is 
30 seconds. 

3. //FORMS JOB TIME=5 

Specifies that the maximum amount of time the job can use the CPU is 
5 minutes. 

4. //RAINCK JOB TIME=14U0 

Specifies that the job is not to be timed. Therefore, the job may 
use the CPU and may remain in a wait state for an unspecified period 
of time. 
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The TYPRUN Parameter (For MFT, MVT) 

TYPRU1S1=H0LD 



HOLD 

specifies that the job is to be held in the job queue until the 
operator issues a RELEASE command. 



Rules for Coding 

1. If the TYPRUN=HOLD parameter is coded for PCP, the parameter is not 
used, but is checked for syntax. 



Holding a Job 

Code TyPRUN=HOLD when the job should be held for execution until some 
event has occurred. The operator must be informed of what it is you are 
waiting for. When the event has occurred, the operator issues a RELEASE 
command, thereby allowing the job to be selected for processing. 



Example o£ the TYPRUN Parameter 

Jobs UPDATE and LIST are to be submitted for execution. The job UPDATE 
uses a program that adds and deletes members to a library; the job LIST 
uses a program that lists the members of a library. In order to get an 
up-to-date listing of the library, UPDATE must be executed before LIST. 
This is accomplished by coding TYPRUN=HOLD on the JOE statement for the 
job named LIST. If a DISPLAY JOBNAMES command is issued by you or the 
operator, the operator is notified on the console when UPDATE has 
completed processing; he issues a RELEASE coirmand for LIST. The job 
LIST can then be selected for execution. 
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Section III: The EXEC Statement 



The EXEC statement is the first statement of each job step and cataloged 
procedure step. The EXEC statement is followed by DD statements and 
data that pertain to the step. The principal function of the EXEC 
statement is to identify the program to be executed or the cataloged 
procedure to be called. All other parameters in the operand field are 
optional. A job cannot contain more than 255 job steps and procedure 
steps . 




EXEC Statement Format 

J //stepname EXEC operands comments 



The EXEC statement consists of the characters //, in columns 1 and 2, 
and four fields — the name, operation (EXEC) , operand, and comments 
fields. 



Rules for Coding 



Follow the order listed below when coding the EXEC statement: 
1. Code the characters // in columns 1 and 2. 



1-10 11-20 



. r T2W475T6T7^T9l0TTT2[3T4l5|6|7|8T9]0Tr|2|3|4|5|6|7|8|9i0|l|2|5|4|5T6r7T8^ 



2. Optionally, you may assign a name to the job step; if you do, code 
the stepname starting in column 3. 



I-IO 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 
TT2r3l4T5l6l7l8[9|0 


71-80 
1 l2l3T4l5l6l7l8l9lO 


l|2|3|4|5|6|7|8|9|0 


1|2|3|415|6|7|8|9|0 


I|2|3|4|5l6|7|8l9|0 


I|2|3l4|5|6|7|8|9|0 


I|2i3|4|5|6|7|8l9l0 


I|2|3|4|5|6i7l8|9|0 


lj,Sj,e\Pj, , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , . 1 , , , , 1 , , , , 1 , , , , 1 , , , 1 , , , , 1 , , , , 



3. Follow the stepname or // with at least one blank. 

4. Code EXEC. 



1 r'-'° ""V 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 


i 1 l2T3r4T5r6l7l8F9[0 


lT2T3|4l5l6T7l8r9lO 


I|2|3|4l5l6|7|8|9|0 


l|2|3|4|5|6|7i8|9|0 


I|2l3|4|5|6|7|8|9!0 


1 |2|3|4|5|6|7|8|9|0 


||2|314|5|6|7|8|9|0 


lii?l3i4|5|6|7|8|9lP 


\UM£iPl^M 


£L ...I ,,. ,_._...! ..,..,,,, 1 ,^^.,1 ,, . ^_ui,,, ,. .. , 1 , , , , 1 , , . , 1 , , , , 1 , , , , 1 1 , , . , 



5. Follow EXEC with at least one blank. 
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6. Identify the program to be executed CPGiy!) , or the cataloged 

procedure to be called (PROC) . (When you are calling a procedure, 
you may omit PROC=.) 



I-IO 


11-20 21-30 


31-40 41-50 


51-60 


61-70 71-80 


I|2|3|4l5|6|7|8|9l0 


TI2T3T4 I5T6T7T8T9T0 n 2T3l4 rsTeTtTs I9T0 


|2|3|4l5|6|7|8l9|0 1 |2|3l4|5|6|7l8|9|0 


|2|3|4|5l6|7|8|9|0 


I|2l3|4|5|6|7|8i9|0 1 |2|3|4|5|6|7|8|9|0 


lixr^\ej: Mpc^ y6m,^,V£m,f.f. , 1 , , , , 1 


-^ J._.L._J. Ll_..J J,..J l_.L .1_J. .i. .Lj,..J....J. X. j 





7 . Code any desired keyword parameters . Separate each parameter with 
a comma . 



miiiisieinirsip; 



11-20^" 1 '21-30 ^ r 31-40 ' 1 " 7 4'~50 " ' . I ' . '^"'"^Q. ' 1. . T^'~'^. . . [ . T . ^'~^° . 

n2 lin4T5TWl8r9l0tlT2l3r4 T5r6|7]8l9TbTlM3 ^^^^ I |2|3|4|5|6|7|8|9|0| I |2|3|4|5|6|7 | 8|9|o | I |2|3|4| 5 | 6 |7| 8 | 9 f 



U^i:^\£A.^£J:^^M^-^^Mlsi^2MJ^[\Ljd.i^n^^^^^ 



8. Code at least one blank. 

9. Code any desired comments. 



i l-IO 

1 1 in"3|4[5T6T7T8T9]0 



11-20 

n2jll4]5l6l7]8l?JO 



21-30^ T 31-40' "T' ""'41-50 

"lT2l3l4[5l6r 7l8r9l0"l 'l ]2 T 3]"4["5T6l"7T"8T9Totl r2l3 r4T5r6T7T8T9l'0' 



n2T3|4T5T6T7T8 l9lO' 



lT2T3l4T5T6[7T8T9T0nT2]3l4T5T6T7|6|9|0 



\U^{r^PJ, i^.'(i£gL_£M£dl^&i|££;^.aA.gAgZ^^ &.OB \,,C.M£C\K, .OM.T \ PM.r. 



Positional and Keyword Parameters 

There are two types of parameters that can be coded on the EXEC 
statement : 

Positional parameters , which must precede any keyword parameters. One 
of the following two positional parameters is coded: 

PGM CPCP, MET, MVT) 
PROC (PCP, MET, MVT) 

These positional parameters are described in the following pages in the 
order listed above. 

Keyword parameters , which may be coded in any order after the positional 
parameter. Any of the following keyword parameters can be coded on the 
EXEC statement: 

ACCT (PCP, MET, MVT) 
COND (PCP, MET, MVT) 
DPRTY (MVT) 
PARM (PCP, MET, MVT) 
RD (PCP, MET, MVT) 
REGION (MVT) 
ROLL (MVT) 
TIME (MET, MVT) 

These keyword parameters are described, after the positional parameters, 
in the order listed above. 
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Sample EXEC Statements 

1. //STEP 4 EXEC PGM=DRBC,PARM=*3018,NO' 

2. // EXEC PGM=ENTRY,REGION=80K,TIME=(2,30) ,DPRTY=(11,11) 

3. //FOR EXEC PROC=PE48 9,TIME=4 

4. //PIC4 EXEC SAL83,ACCT.STEP1=123019 




Section III: The EXEC Statement 67 



Assigning a Stepname 

(V/stepname EXEC 



The stepname identifies a job step within a job. The stepname is 
optional. You must assign a stepname if you wish to do any of the 
following : 

1. Make backward references to the step. 

2. Override parameters on an EXEC statement or DD statement in a 
cataloged procedure step, and add DD statements to a cataloged 
procedure step. 

3. Perform a step or checkpoint restart at or within the step. 

The stepname must begin in column 3 of the; EXEC statement and must 
consist of 1 through 8 alphameric and national (a, #, $) characters. 
The first character must be an alphabetic or national character. Each 
stepname within a job or a cataloged procedure must be unique. 




Examples o£ Valid Stepnames 



1. //STEP 4 EXEC 

2. //aLOC EXEC 

3 . //PRINT EXEC 



Section III: The EXEC Statement — Assigning a Stepname 6 9 



The PGM Parameter (For PGP, MFT, MVT) 

PGM= (program name 

< * . s tepname . ddname 

( * • stepname . procstepname . ddname 



program name 

is the member name or alias of the program to be executed. The 
program must be a member of a partitioned data set that resides in 
a temporary, system, or private library. 

♦.stepname. ddname 

is a backward reference to a DD statement that defines, as a member 
of a partitioned data set, the program to be executed; stepname is 
the name of the step in which the DD statement appears. Usually, 
this form is used when a previous job step creates a temporary 
partitioned data set to store one program until the program is 
required. 

*. stepname . procstepname . ddname 

is a backward reference to a DD statement within a cataloged 
procedure step that defines, as a member of a partitioned data set, 
the program to be executed. Stepname is the name of the step that 
calls the procedure, and procstepname is the name of the procedure 
step that contains the DD statement. Usually, this form is used 
when a cataloged procedure step, called by an earlier job step in 
the job, creates a temporary partitioned data set to store a 
program until the program is required. 




Identifying the Program to Be Executed 

All programs that can be executed are members of partitioned data sets 
(libraries). The library that contains the program may be a temporary 
library, the system library, or a private library. In order to execute 
a program contained in any of these libraries, you must code the PGM 
parameter as the first parameter on the EXEC statement. 



TEMPORARY LIBRARY 

If in a job you want to assemble, linkage edit, and then execute a 
program, you must make the output of the linkage editor a member of a 
partitioned data set. This is accomplished by creating a temporary 
library. A temporary library is a partitioned data set created in the 
job to store a program, as ci member of the data set, until it is 
executed in a following job step. When the program is required, you may 
refer back to the DD statement that defines the temporary library and 
the member by coding PGM=*. stepname. ddname or 

PGM=*.stepname.procstepname,. ddname. You may also request use of a 
program that is a member of a temporary library by coding PGM=program 
name and including a DD statement named JOBLIB or STEPLIB that defines 
the temporary libra!ry. (Information on the JOBLIB and STEPLIB DD 
statements can be found in the chapter "Assigning a Ddname" in Section 
IV of this publication. ) 

If you want to keep this program available for use by other jobs, you 
must make the program a member of the system library or a private 
library. 

Section III: The EXEC Statement — PGM Parameter 71 



SYSTEM LIBRARY 

The system library is a partitioned data set named SYSl.LINKLIB and it 
contains frequently used programs, as well as programs used by the 
system. You request the use of a program that is a member of the system 
library simply by coding PGM=program name. The system automatically 
looks in SYSl.LINKLIB for a member with the corresponding name, 

A program that resides in the system library may also be executed by 
coding PGM=*.stepname.ddname or PGM=*.stepname.procstepname,ddname. 
This can be done only when the named DD statement defines the program as 
a member of the system library. 



PRIVATE LIBRARY 

A private library is a partitioned data set that contains programs not 
used frequently enough to warrant their inclusion in the system library. 
You request use of a program that is a member of a private library by 
coding PGM=program name and including a DD statement named JOBLIB or 
STEPLIB that defines the private library. The system automatically 
looks in the private library and, if the program is not found there, in 
SYSl.LINKLIB for a member with the corresponding name. (Information on 
the JOBLIB and STEPLIB DD statements can be found in the chapter 
"Assigning a Ddname" in Section IV of this publication.) 

A program that resides in a private library may also be executed by 
coding PGM=*.stepname. ddname or PGM=*.stepname.procstepname. ddname. 
This can be done only when the named DD statement defines the program as 
a member of a private library. 



THE lEFBRlU PROGRAM 

If space allocation and disposition processing requests are contained in 
your job control statements, you can satisfy these requests prior to 
executing your program. To do this, substitute lEFBRlU for your 
program's name. This also allows you to check the accuracy of your 
control statements. (If you create a data set when using this program, 
the data set's status will be old when you execute your own program.) 



Examples o£ the PGM Parameter 

1. //STEPl EXEC PGM=TABULATE 

Specifies that the program named TABULATE is a member of 
SYSl.LINKLIB. 

2. //JOBS JOB MSGLEVEL=(2,0) 

//JOBLIB DD DSNAME=DEPT12.LIBU,DISP= (OLD, PASS) 
//STEPl EXEC PGM=USCAN 

Specifies that the system is to look for the program named USCAN in 
a private library named DEPT12.LIBU, and, if not found there, the 
system is to look in the system library. 
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//CREATE 


EXEC 


//SYSLMOD 


DD 


// 




//EXCUTE 


EXEC 



3. //CREATE EXEC PGM=IEWL,REGION=96K 

DSNAME=€6PARTD.S(PR0G) , UNIT=2 311, DISP= (MOD, PASS) , X 
SPACE=(1024, (50,20,1)) 
PGM=* . CREATE . SYSLMOD 

Use of backward reference; to a DD statement that defines a temporary 
library created in the step named CREATE. The program named PROG is 
stored as a member of the partitioned data set named g&PARTDS and is 
executed in the step named EXCUTE. 

U. //STEP2 EXEC PGM=UPDT 

//DDA DD DSNAME=SYS1.LINKLIB(P40),DISP=OLD 
//STEP3 EXEC PGM=*.STEP2.DDA 

Use of backward reference to a DD statement that defines the system 
library. The program named P40 is stored as a member of 
SYSl.LINKLIB and is executed in the step named STEP3. 

5. //CHECK EXEC PGM=IEFBR14 

Executing the program named lEFBRlU allows you to satisfy space 
allocation and disposition processing requests prior to executing 
your program. The remaining job control statements in the job are 
also checked for syntax. 
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The PROC Parameter (For POP, MFT MVT) 

rPROC=procedure name) 
(procedure name f 



procedure name 

the member name (or alias) of the cataloged procedure or the name 
of the in-stream procedure to be called. 



I Identifying the Cataloged or In-stream Procedure to Be Called 




A cataloged procedure is a set of job control statements that has been 
placed in a special partitioned data set referred to as the procedure 
library. (The IBM-supplied procedure library is named SYSl.PROCLIB; at 
your installation, there may be additional procedure libraries, which 
would have different names.) Each cataloged procedure is a member of 
this data set. An in-stream procedure is a set of job control 
statements, beginning with a PROC statement and ending with a PEND 
statement, that have been placed in the input stream. An in-stream 
procedure can be executed any number of times during the job in which it 
appears. Both cataloged and in-stream procedures consist of one or more 
procedure steps; each procedure step consists of an EXEC statement, 
which identifies the program to be executed, and DD statements, which 
define the data set requirements of the step. 

In order to use a cataloged or in-stream procedure, you must code the 
PROC statement as the first parameter on the EXEC statement, instead of 
the PGM parameter, and give the name of the cataloged procedure. You 
can, instead, code only the cataloged or in-stream procedure name; the 
job scheduler will recognize that it is a procedure name since it must 
appear first in the operand field. 

When the EXEC statement specifies that a cataloged or in-stream 
procedure is to be called, subsequent parameters in the operand field 
can be used to override EXEC statement parameters in the procedure. 
Also, any DD statements that follow the EXEC statement are either 
overriding DD statements or DD statements that are to be added to the 
cataloged or in-stream procedure for the duration of the job step. 
Overriding and adding to cataloged procedures are discussed in the 
chapter "Using Cataloged and in-stream Procedures" in Appendix A of this 
publication. 



Examples o£ the PROC Parameter 

1. //SP3 EXEC PROC=PAYWKRS 

Specifies that the cataloged or in-stream procedure named PAYWKRS is 
to be called. 

2. //BK3 EXEC OPERATE 

Specifies that the cataloged or in-stream procedure named OPERATE is 
to be called. This specification has the same effect as coding 
PROC=OPERATE . 
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The ACCT Parameter (For POP. MFT, MVT) 

ACCT= (accounting inf oririation , . . . ) 

accounting information 

includes one or more subparameters of accounting information to be 
passed to the installation's accounting routines by the system. 



Rules for Coding 

1. If the accounting information includes several subparameters, each 
must be separated by a comma, 

2. If the accounting information consists of only one subparameter, 
you need not code the parentheses. 

3. The maximum number of characters of accounting information, plus 
the commas that separate the subparameters, is 142. 

4. If a subparameter contains special characters (other than a 
hyphen) , enclose the subparameter in apostrophes . The apostrophes 
are not considered part of the information. If one of the special 
characters is an apostrophe, code two consecutive apostrophes in 
its place. 



Providing Accounting Information for a Job Step or Procedure Step 

Code the ACCT keyword parameter when you want to provide accounting 
information for a step. If the job step calls a cataloged procedure, 
the ACCT parameter overrides any ACCT parameters coded in the procedure 
steps and pertains to all the procedure steps. If different steps in 
the procedure require different accounting information, code 
ACCT. procstepname= (accounting information,...) for each step that 
requires accounting information. Accounting information will then 
pertain only to the named procedure step. 



Examples of the ACCT Parameter 

1. //STEPl EXEC PGM=JP5, ACCT=( LOCATION 8, 'CHGE+3») 

Specifies that this accounting information pertains to this job 
step. 

2. //STP3 EXEC LOOKUP,ACCT=( V83468M 

Specifies that this information pertains to this job step. Since 
this step calls a cataloged procedure, the accounting information 
pertains to all the steps in the procedure. 

3. //STP4 EXEC BILLING, ACCT. PAID=56370, ACCT. LATE=56U70, X 
// ACCT. BILL=* 121+366" 

Specifies that different accounting information pertains to each of 
the named procedure steps (PAID, LATE, and BILL). 
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The COND Parameter (For POP, MFT. MVT) 

r 

[code, operator) »•••[»] 

[ONLY 



COND= ( 



(code, operator) 

( code , operator , stepname ) 

( code , operator , stepname . procstepnaine) 



,...[,](even]) 

J 



code 

a decimal number from through 4095. This number is compared with 
the return code issued by all previous steps or a specific step. 

operator 

the type of comparison to be made with the return code. Relational 
operators and their meanings are: 

GT... greater than 

GE... greater than or equal to 

EQ . . . equal to 

LT. . .less than 

LE...less than or equal to 

NE-..not equal to 

stepname 

the name of a preceding job step that issued the return code to be 
tested. 

stepname . procstepname 

the name of a procedure step "procstepname" that issued the return 
code to be tested; the procedure step -is part of a procedure that 
was called by an earlier job step named "stepname." 

EVEN 

specifies that the job step is to be executed even if one or more 
of the preceding job steps have abnormally terminated. If the 
current job step specifies that return code tests are to be made 
and if any of the tests are satisfied, this job step is bypassed. 
Do not code EVEN when ONLY is coded. 

ONLY 

specifies that the job step is to be executed only if one or more 
of the preceding job steps have abnormally terminated. If the 
current job step specifies that return code tests are to be made 
and if any Of the tests are satisfied, this job step is bypassed. 
Do not code ONLY when EVEN is coded. 

Rules for Coding 

1. when neither EVEN nor ONLY is coded, you can make as many as eight 
tests on return codes issued by preceding job steps or cataloged 
procedure steps, which completed normally. When either EVEN or 
ONLY is coded, you can make as many as seven tests on return codes. 

2. If you want only one test made, you need not code the outer 
parentheses . 

3. If you code only EVEN or ONLY, you need not enclose it in 
parentheses. 

U. If you want each return code test to be made on the return code 
issued by every preceding step, do not code a stepname. 

5. The EVEN or ONLY subparameter can appear before, between, or after 
retiirn code tests. 

Section III; The EXEC Statement — COND Parameter 79 




Using the COND Parameter 

The COND keyword parameter can be used to eliminate unnecessary use of 
computing time by basing the execution of a job step on the successful 
completion of one or more preceding job steps. When the COND parameter 
is coded on the JOB statement, any return code test that is satisfied 
causes all remaining job steps to be bypassed. If, instead, yoy want a 
particular job step to be bypassed when a return code test is satisfied, 
code the COND parameter on the EXEC statem.ent. Besides allowing you to 
specify the conditions for bypassing a job step, the COND parameter 
allows you to specify the condition for executing a job step. 

The compiler, assembler, and linkage editor programs issue return 
codes. You may want to use the COND parameter to test these return 
codes. If you write your processing programs in assembler language or 
PL/I, you can use the COND parameter to test return codes issued by your 
programs. 

BYPASSING A JOB STEP 

The return code tests specified in the COND parameter determine whether 
a job step is to be bypassed. Each return code test consists of a code, 
an operator, and, optionally, a stepname. The operator indicates the 
mathematical relationship between the code specified on the EXEC 
statement and the code returned by a completed job step. The operator 
or operators are compared with the return code or codes and if any of 
the relationships are true, the job step is bypassed. 

If the return code test includes a stepname, the test is made using 
the return code issued by the named step. If the return code test does 
not include a stepname, the test is made using the return code issued by 
every preceding job step that completed normally. To test in a later 
job step the return code issued by a cataloged procedure step, specify 
both the name of the job step that called the procedure and the 
procedure stepname, i.e., stepname. procstepname. 

EXECUTING A JOB STEP 

Abnormal termination of a job step normally causes subsequent steps to 
be bypassed and the job to be terminated. By means of the COND 
parameter, you can specify the condition for executing a job step after 
one or more of the preceding job steps have abnormally terminated. For 
the COND parameter, a job step is considered to abnormally terminated if 
a failure occurs within the user's program once it has received control. 
(If, during scheduling, a job step is not scheduled for execution 
because of failures such as job control language errors or inability to 
allocate space, the remainder of the job steps are bypassed, whether or 
not a condition for executing a later job step was specified.) 

The condition for executing a job step after one or more of the 
preceding job steps have abnormally terminated is either EVEN or ONLY. 
EVEN causes the step to be executed even if one or more of the preceding 
job steps have abnormally terminated; ONLY causes the step to be 
executed only if one or more of the preceding job steps have abnormally 
terminated. When a job step abnormally terminates, the COND parameter 
on the EXEC statement of the next step is scanned for the EVEN or ONLY 
subparameter. If neither is specified, the job step is bypassed and the 
EXEC statement of the next step is scanned for EVEN or ONLY. If EVEN or 
ONLY is specified, return code tests, if any, are made on all previous 
steps specified that did not abnormally terminate. If any one of these 
tests is satisfied, the job step is bypassed. Otherwise, the job step 
is executed. 
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Caution ; When a job step that contains the iiVEN or ONLY subparameter 
refers to a data set that was to be created or cataloged in a preceding 
step, the data set (1) will not exist if the step creating it was 
bypassed, or (2) may be imcomplete if the step creating it abnormally 
terminated. Also, if the job step refers the system to an earlier job 
step for volum.e and unit information, this information is not available 
if the earlier job step was bypassed. 



WHEN YOU CALL A CATALOGED PROCEDURE 



The COND parameter may be coded on the EXEC statement of a cataloged 
procedure step. If the job step calls a cataloged procedure, you may 
want to override all COND parameters in the procedure or only certain 
COND parameters. To override all COND parameters, code the COND 
parameter on the EXEC statement that calls the procedure. This 
establishes one set of return code tests emd the EVEN or ONLY 
subparameter for all steps in the procedure. To override only certain 
COND parameters, code, on the EXEC statemient that calls the procedure, 
COND.procstepname for each procedure step that you want to override. 
Retiirn code tests and the EVEN or ONLY subparameter will then pertain 
only to the named procedure step. 




Examples of the COND Parameter 

1. //STEP6 EXEC PGM=BAB,C0ND=(U,GT,STEP3) 

If U is greater than the return code issued by STEP3, this step is 
bypassed. (A return code of U or greater allows this step to be 
executed.) since neither EVEN nor ONLY is specified, this job step 
is automatically bypassed if a preceding step abnormally terminates . 

2. //TEST2 EXEC PGM=BACK,COND= ( C16, GE) , (90,LE, STEPl) , ONLY) 

If 16 is greater than or equal to the return code issued by any of 
the preceding job steps or if 9 is less than or equal to the return 
code issued by STEPl, this step is bypassed. If none of the tests 
are satisfied (any return code of 17 through 89 does not satisfy tne 
tests) and a preceding job step has abnormally terminated, this step 
is executed because ONLY is coded. 

3. //PRCH EXEC PGM=SPE,COiNiD=(l 2, EQ, STEP U. LOOKUP) 

If 12 is equal to the return code issued by the procedure step named 
LOOKUP, the job step is bypassed. Since neither EVEN nor ONLY is 
specified, this job step would be automatically bypassed if a 
preceding step abnormally terminated. 

4. //STPU EXEC BILLING, COND. PAID=( EVEN, (2 0,LT)), X 
// COND.LATE={60,GT,FIND) ,COND .EILL= ( (20 ,GE) , (30 ,LT, CHGE) ) 

Specifies that different return code tests pertain to each of the 
named procedure steps (PAID, LATE, and BILL). If the return code 
test specified for the procedure step named PAID is not satisfied, 
the step is executed even if a preceding step abnormally terminated. 
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The DPRTY Parameter (For MVT) 

DPRTY= (valuel,value2) 

valuel 

a number from through 15. If you do not assign a number, a value 
of is assumed. 

value 2 

a number from through 15. If you do not assign a number, a value 
of 11 is assumed. 



Rules for Coding 

1. Avoid assigning a number of 15 to valuel. This number is used for 
certain system tasks. 

2. If you omit value2 , you need not code the parentheses. 

3. If you omit valuel, you must code a comma preceding value2 to 
indicate the absence of valuel. 

U. If the DPRTY parameter is coded for PCP or MFT, the param.eter is 
not used, but is checked for syntax. 



Assigning a Dispatching Priority 

The DPRTY parameter is used to assign a dispatching priority to a job 
step. Dispatching priority determines in what order tasks will use main 
storage and CPU resources. If you do not code the DPRTY parameter, the 
job step is assigned the priority assigned to the job either on the JOB 
statement (the PRTY parameter) or by default. 

Valuel of the DPRTY parameter has the same meaning as the value you 
assign in the PRTY parameter. That is, if you code PRTY=10 on the JOB 
statement and DPRTY=10 on the EXEC statement, the job and step priority 
are the same. Also, in this case the job and step have the same 
dispatching priority. This is because the system converts the number 10 
to an internal priority and then adds 11 to the internal priority to 
form the dispatching priority (11 is always the number added to the 
job's internal priority; 11 is the number added to the job step's 
internal priority when value2 of the DPRTY parameter is omitted) . 

If you code value2 of the DPRTY parameter, the system adds that value 
to the internal priority to form the dispatching priority. (The 
internal priority is formed by the system by converting the value 
assigned to valuel in the DPRTY param^eter.) 

When you want the job step to have a different dispatching priority 
than the job, you code the DPRTY parameter and either raise or lower thf? 
values, depending on whether the step is to have a higher or lower 
priority than the job. 
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THE DPRTY PARAMETER AND TIME-SLICING 

If your installation provides time-slicing facilities in a system with 
MVT, the DPRTY parameter can be used to make a job step part of a group 
of jobs and job steps to be time-sliced. (To make an entire job part of 
a group of jobs and job steps f-o be time- si iced, code the PRTY parameter 
on the JOB statement.) At system generation, the priorities of the 
time-sliced groups are selected. If the number assigned to "valuel" 
corresponds to a priority number selected for time-slicing and "value2" 
is either omitted or assigned a value of 11, then the job step's tasks 
will be time-sliced. 

WHEN YOU CALL A CATALOGED PROCEDURE 

The DPRTY parameter may be coded on the EXEC statement of a cataloged 
procedure step. If the job step calls a cataloged procedure, you iray 
want to override all DPRTY parameters in the procedure or only certain 
DPRTY parameters. To override all DPRTY parameters, code the DPRTY 
parameter on the EXEC statement that calls the procedure. This 
establishes one dispatching priority for all the steps in the procedure. 
To override only certain DPRTY parameters, code, on the EXEC statement 
that calls the procedure, DPRTY. procstepncime for each procedure step 
that you want to override. The dispatching priority will then pertain 
only to the named procedure step. 



Examples o£ the DPRTY Parameter 

1. //BP2 EXEC PGM=FOUR,DPRTY=(13,9) 

The system uses these numbers to form a dispatching priority for 
this step. Since the numbers are high, the dispatching priority 
will be high. 

2. //STEP 3 EXEC PGM=BR0WN31 ,DPRTY= ( ,12) 

The system first assigns a value of to the absent subparameter and 
then forms a dispatching priority. In this case, the dispatching 
priority will be very low. 

3. //ST2 EXEC C0MP,DPRTY=4 

The system assigns a dispatching priority of 4 to all steps in the 
procedure named COMP. 
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The FARM Parameter (For POP, MFT, MVT) 



PARM=value 



value 



consists of up to 100 characters of inforiration or options that the 
system is to pass to the processing program. 



Rules for Coding 

1. If the value contains more than one expression separated by commas, 
the value must be enclosed in apostrophes or parentheses, e.g., 
PARM='P1,123,MT5* or PARM=(Pl, 123,MT5) . (Enclosing apostrophes and 
parentheses are not passed to the processing program; commas within 
apostrophes and parentheses are passed as part of the value.) 

2. If any expression contains special characters, either (1) enclose 
the value in apostrophes, or (2) enclose the expression in 
apostrophes and the value in parentheses, e.g., PAR]yj='P50, 12+80* or 
PARM=(P50, •12+80') . (The enclosing apostrophes and parentheses are 
not considered part of the value.) If one of the special 
characters is an apostrophe, code two consecutive apostrophes in 
its place, e.g., PARM= • CONTROL INFORM* 'N'. If one of the special 
characters is an ampersand and you are not defining a symbolic 
parameter, code two consecutive ampersands in its place, e.g. , 
PARM=*3462S&5' . (When two apostrophes or two ampersands are coded, 
only one is passed to the processing program.) 

3. If the value must be continued on another statement, enclose the 
value in parentheses. The continuation comma is considered part of 
the value field and counts towards the maximum of 100 characters of 
data. You may not continue on another statement any value enclosed 
in apostrophes. 

Providing a Processing Program With Information 
at Execution Time 

Some information required by a program may vary from application to 
application, such as module attributes and options required by compiler, 
assembler, and linkage editor programs. In order to provide this 
information to the program at the time it is executed, you can code the 
PARM keyword parameter. The program must include instructions that can 
retrieve this information. (The exact location and format of the 
information passed to a processing program are described under the topic 
"Program Management" in Section I of Supervisor and Data Management 
Services . ) 

WHEN YOU CALL A CATALOGED OR IN- STREAM PROCEDURE 

The PARM parameter may be coded on the EXEC statement of a cataloged or 
in-stream procedure step. If the job step calls a cataloged or 
in-stream procedure, you can pass information to the first procedure 
step and nullify all other PARM parameters in the procedure or override 
some of the PARM parameters contained in the procedure. To accomplish 
the first, code the PARM parameter on the EXEC statement that calls the 
procedure. The information contained in the PARM parameter is passed to 
the first procedure step and PARM parameters in all other procedure 
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steps are nullified. To override some of the PARF. parameters contained 
in the procedure, code, on the EXEC statement that calls the procedure, 
PARM.procstepname for each procedure step that you want to override. 
Information provided is passed only to the named procedure step. 



Examples o£ the PARM Parameter 

1, //RUN3 EXEC PGM=APG22,PARM=(P1,123, 'P2=5' ) 

The system passes the information in the PARI4 parameter, except the 
apostrophes, to the processing program named APG22. 

2, // EXEC PROC81,PARM=MT5 

The system passes this information to the first step of the 
procedure named PR0C81 . If any of the other procedure steps contain 
the PARM parameter, these parameters are nullified - 

3, //STP6 EXEC ASMFCLG, PARM. LKED=( MAP, LET) 

The system passes this information to the procedure step named LKED. 
If any of the other procedure steps contain the PARM parameter, 
these parameters are still in effect. 
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The RD Parameter (For POP, MFT, MVT) 

rd=|r 

Irnc 

INC 

|nr 

R 

specifies that automatic step restart is permitted. 

RNC 

specifies that automatic step restart is permitted and automatic 
checkpoint restart is not permitted and no checkpoints can be 
established. 




NC 



NR 



specifies that neither automatic step restart nor automatic 
checkpoint restart is permitted and no checkpoints can be 
established. 



specifies that neither automatic step restart nor automatic 
checkpoint restart is permitted, but the CHKPT macro instruction 
can establish a checkpoint. 



Rules for Coding 

1. Be sure to code MSGLEVEL=(1,1) , MSGLEVEL=(1,0) , or MSGLEVEL=1 in 
MFT and MVT when RD=R or RD=R1SIC is specified. 

2. If you are permitting automatic step restart, assign the step a 
unique step name. 

3. If you have coded the RD parameter on the JOB statement, RD 
parameters on the job's EXEC statements are ignored. 



Using the Restart Facilities 

The RD (restart definition) keyword parameter is coded when you want to 
make use of the step restart facilities, to suppress the action of the 
CHKPT macro instruction, or to suppress automatic restarts. The step 
restart facilities permit execution of a job to be automatically 
restarted at a job step after the job abnormally terminates or, in MFT 
and MVT, after a system failure occurs. Through the RD parameter, you 
can specify that execution of a job step is to be automatically 
restarted at the beginning of the step if it abnormally terminates (step 
restart) . 

Execution of a job step can also be automatically restarted within 
the step if it abnormally terminates (checkpoint restart). In order for 
checkpoint restart to occur, the CHKPT macro instruction must have been 
executed in the processing program before abnormal termination. When 
you use the RD parameter to request suppression of the CHKPT macro 
instruction action, automiatic checkpoint restart cannot occur. 

If the RD parameter is not coded, step restart cannot occur. If the 
RD parameter is not coded and the processing program contains CHKPT 
macro instructions, checkpoint restart can occur. 
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The following two conditions must be met before automatic step or 
checkpoint restart can occur: (1) the completion code returned during 
abnormal termination indicates that the step is eligible for restart, 
and (2) the operator authorizes restart. In addition, for automatic 
step restart to occur in MFT or MVT, MSGLEVEL= (1,0) , MSGLEVEL= ( 1 , 1) , or 
MSGLEVEL=1 must be coded on the JOB statement. If these conditions are 
satisfied, special disposition processing is performed before restart. 
If automatic step restart is to occur, all data sets in the restart step 
with a status of OLD or MOD, and all data sets being passed to steps 
following the restart step, are kept. All data sets in the restart step 
with a status of NEW are deleted. If automatic checkpoint restart is to 
occur, all data sets currently in use by the job are kept. 



DEFINING RESTART 

You define the type of restart that can occur by coding one of the 
subparameters of the RD parameter: R, RNC, NC, or NR. Each of these 
subparameters is described in detail in the following paragraphs. 

RD=R ; R indicates that automatic step restart is permitted. If the 
processing program used by the job step does not include any CHKPT macro 
instructions, coding RD=R allows execution to be resumed at the 
beginning of this step if it abnormally terminates. If the program does 
include a CHKPT macro instruction, coding RD=R permits automatic step 
restart to occur only if the step abnormally terminates before execution 
of the CHKPT macro instruction; thereafter, only checkpoint restart can 
occur. If you cancel the effects of the CHKPT macro instruction before 
a checkpoint restart is performed, the request for automatic step 
restart is again in effect. 

RD=RNC ; RNC indicates that autom.atic step restart is permitted and 
automatic checkpoint restart is not permitted . RD=RNC should be 
specified when you want to suppress the action of all CHKPT macro 
instructions included in the processing program and to permit automatic 
step restart. 

RD=NC : NC indicates that neither automatic step restart nor automatic 
checkpoint restart is permitted. RD=NC should be specified when you 
want to suppress the action of all CHKPT macro instructions included in 
the processing program and not to permit automatic step restart. RD=NC 
has no effect on processing if CHKPT macro instructions are not included 
in the program. 

RD=NR : NR indicates that a CHKPT macro instruction can establish a 
checkpoint, but neither automatic step restart nor automatic checkpoint 
restart is permitted. Coding RD=NR allows you to resubmit the job at a 
later time and specify in the RESTART parameter the checkpoint at which 
execution is to be resumed. (The RESTART parameter is coded on the JOB 
statement of the resubmitted job.) RD=NR has not effect on processing 
if CHKPT macro instructions are not included in the program. 

WHEN YOU CALL A CATALOGED PROCEDURE 

The RD parameter may be coded on the EXEC statement of a cataloged 
procedure step. If the job step calls a cataloged procedure, you may 
want to override all RD parameters in the procedure or only certain RD 
parameters. To override all RD parameters, code the RD parameter on the 
EXEC statement that calls the procedure. This establishes one restart 
request for all the steps in the procedure. To override only certain RD 
parameters, code, on the EXEC statement that calls the procedure, 
RD.procstepname for each procedure step that you want to override. The 
restart request will then pertain only to the named procedure step. 
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References 

1. For detailed information on the checkpoint/restart facilities, 
refer to the publication Advanced Checkpoint/Restart Planning 
Guide , the topic "Checkpoint and Restart" in the publication 
Supervisor and Data Management Services , and "Using the Restart 
Facilities" in Appendix B of this publication. 

2. For information on how to code the CHKPT macro instruction, refer 
to the publication Supervisor and Data Management Macro 
Instructions . 



Exaniples of the RD Parameter 

1. //STEPl EXEC PGM=GIIM,RD=R 

Permits execution to be automatically restarted with this step if it 
abnormally terminates. 

2. //NEST EXEC PGM=T18 ,RD=RNC 

Permits execution to be automatically restarted with this step if it 
abnormally terminates; suppresses the action of CHKPT macro 
instructions issued in the program this job step uses . 

3. //CARD EXEC PGM=WTE , RD=NR 

Neither automatic step restart nor automatic checkpoint restart can 
occur, but CHKPT macro instructions issued in the program that this 
job step executes can establish checkpoints. 

H. //STPU EXEC BILLING, RD.PAID=NC,RD.BILL=NR 

Specifies that different restart requests pertain to each of the 
named procedure steps (PAID and BILL) . 
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The REGION Parameter-Without Main Storage Hierarchy 
Support (For MVT) 

REGION=valueK 



valueK 

specifies the number of contiguous 102U-bYte areas of main storage 
to be allocated to the job step. The number can range from one to 
five digits but may not exceed 16383. 



EXEC 



Rules for Coding 

1. Code an even number. (If you code an odd number, the system, treats 
it as the next highest even number. When the value 16383K is 
coded, the system treats it as 16384K. However, the value 1638UK 
must not be coded on the EXEC statement . ) 



2. 



If you have coded the REGION paramieter on the JOB statement, REGION 
parameters on the job's EXEC statements are ignored. 

If the REGION parameter is coded for PCP or MET, the parameter is 
not used, but is checked for syntax. 



Requesting Main Storage 

The REGION keyword parameter is used to specify how much main storage, 
in contiguous bytes, is to be allocated to the job step. Code the 
REGION parameter when you want more storage or less storage than would 
be allocated if the default region size was used. The default region 
size is established as a FARM parameter field in the cataloged procedure 
for the input reader. You can consult the Storage Estimates publication 
to help you determine how much main storage is required to process your 
job. 

ACQUIRING ADDITIONAL MAIN STORAGE 

If the step may require use of more main storage than has been 
allocated, you can code the ROLL parameter on either the JOB statement 
or this EXEC statement and request that the system try to provide you 
with additional main storage. The ROLL parameter is described in the 
chapters "The ROLL Parameter" later in this section and in Section II. 

WHEN YOU CALL A CATALOGED PROCEDURE 

The REGION parameter may be coded on the EXEC statement of a cataloged 
procedure step. If the job step calls a cataloged procedure, you may 
want to override all REGION parameters in the procedure or only certain 
REGION parameters. To override all REGION parameters, code the REGION 
parameter on the EXEC statement that calls the procedure. Each 
procedure step will be allocated the same amount of storage. To 
override only certain REGION parameters, code, on the EXEC statement 
that calls the procedure, REGION. procstepname for each procedure step 
that you want to override. The requested region size will then be 
allocated only to the named procedure step. 
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Examples o£ the REGION Parameter 

1. //JUNE EXEC PGM=A1403,REGION=112K 

Specifies that 112 contiguous 1024-bYte areas of main storage are to 
be allocated to the job step. 

2. //STP2 EXEC PGM=RATL,REGION=70K,RCLL=(YES,YES) 

The REGION parameter specifies that 70 contiguous 102U-byte areas of 
main storage are to be allocated to the job step. In the ROLL 
parameter, the first subparameter tells the system that this step 
may be rolled out if additional storage is reguired by another job; 
the second subparameter tells the system that it should try to 
provide this step with additional main storage if it is reguired. 

3. //STP4 EXEC BILLING, REGION. LATE=80K, REGION. BILL=108K 

Specifies that different region sizes are to be allocated to the 
named procedure steps (LATE and BILL) . 
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The REGION Parameter-With Main Storage Hierarchy Support 
(For MVT. Excluding M6SMP) 

REGION= (valueoK,valueiK) 



valueoK 

specifies the number of contiguous 102U-bYte areas in hierarchy 
to be allocated to the job step. If IBM 2361 Core Storage is 
present, the number cannot exceed 16383. 

value^K 

specifies the niamber of contiguous 102U-bYte areas in hierarchy 1 
to be allocated to the job step. If IBM 2361 Core Storage is 
present, the number cannot exceed 1024 (for each Model 1) or 2048 
(for each Model 2). 




Rules for Coding 



1. When processor storage includes hierarchies and 1, the sum of 
valueo and value^ cannot exceed 16383. 

2. code even numbers. (If you code an odd number, the system treats 
it as the next highest even number. When 16383K is coded for 
valueo, the system treats it as 16384K. However, 16384K must not 
be coded for value on the EXEC statement.) 

3. When you are requesting storage only in hierarchy 1, precede value^ 
with a comma, to indicate the absence of valueo- 

4. When you are requesting storage only in hierarchy 0, you need not 
code the parentheses. 

5. If you have coded the REGION parameter on the JOB statement, REGION 
parameters on the job's EXEC statements are ignored. 

6. If the REGION parameter is coded for PCP or MET, the parameter is 
not used, but is checked for syntax. 



Requesting Main Storage in One or Two Hierarchies 



The REGION keyword parameter is used to specify how much main storage is 
to be allocated to each job step, and, when main storage hierarchy 
support has been specified at system generation, in which hierarchy or 
hierarchies to allocate main storage. With main storage hierarchy 
support, storage hierarchies and 1 are provided. If IBM 2361 Core 
Storage, Model 1 or 2, is present in the system, processor storage is 
referred to as hierarchy and 2361 Core Storage is referred to as 
hierarchy 1. If 2361 Core Storage is not present, a two-part region is 
established in processor storage when regions are requested in two 
hierarchies. The two parts are not necessarily contiguous in processor 
storage . 

Code the REGION parameter to specify how much storage is to be 
allocated in each hierarchy, or that all storage for the job step is to 
be allocated in a particular hierarchy. (If you do not code the REGION 
parameter on either the JOB or EXEC statement, the default region size, 
which is a FARM parameter field in the cataloged procedure for the input 
reader, is used and is always allocated in hierarchy 0. If you code the 
REGION parameter and request storage only from hierarchy 1, no hierarchy 
segment will be allocated.) You can consult the Storage Estimates 
publication to help you determine how much main storage is required to 
process the job step. Then, depending on your reasons for using 
hierarchies, determine how much storage is required in each. 
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If main storage hierarchy support was not specified at system 
generation and regions are requested in both hierarchies, the region 
sizes are combined and an atteiicpt is made to allocate a single region 
from processor storage. If a region is requested entirely from 
hierarchy 1, an attempt is made to allocate the region from processor 
storage. 

ACQUIRING ADDITIONAL MAIN STORAGE 

If the job step may require more main storage than has been allocated, 
you can code the ROLL parameter and request that the system try to 
provide you with additional main storage in that hierarchy. The ROLL 
parameter is described in the chapters "The ROIL Parameter" later in 
this section and in Section II. 



WHEN YOU CALL A CATALOGED PROCEDURE 

The REGION parameter may be coded on the EXEC statement of a cataloged 
procedure step. If the job step calls a cataloged procedure, you may 
want to override all REGION parameters in the procedure or only certain 
REGION parameters. To override all REGION parameters, code the REGION 
parameter on the EXEC statement that calls the procedure. Each 
procedure step will be allocated the same amount of storage in the 
specified hierarchies. To override only certain REGION parameters, 
code, on the EXEC statement that calls the procedure, 

REGION. procstepname for each procedure step you want to override. The 
requested region size will then be allocated in the specified 
hierarchies only to the named procedure step. 



Examples of the REGION Parameter 

1. //MART EXEC PGM=TYP,REGION= ( 8 0K, 30K) 

Specifies that the system is to allocate 8 contiguous 1024-byte 
areas of storage in hierarchy and 30 contiguous 102U-byte areas of 
storage in hierarchy 1. If main storage hierarchy support is not 
included in the system, the system will try to obtain 110 contiguous 
102U-byte areas in processor storage. 

2. // EXEC PGM=U1U8 9,REGI0N=(,98K) 

Specifies that the system is to allocate 98 contiguous 1024-byte 
areas of storage in hierarchy 1 . 

3. //RAND EXEC PGM=SSYS ,REGI0N= (lOOK, 50K) ,RCLL= (YES ,YES) 

The REGION parameter specifies that the system is to allocate 100 
contiguous 102i4-byte areas of storage in hierarchy and 50 
contiguous 1024-byte areas of storage in hierarchy 1. In the ROLL 
parameter, the first subparameter tells the system that this step 
may be rolled out if additional storage is required by another job; 
the second subparameter tells the system that it should try to 
provide this step with additional main storage if it is required. 

4. //STPU EXEC BILLING, REGION. PAID=(28K,10K), REGION. LATE=(4UK,8K) 

Specifies that different region sizes are to be allocated to the 
named procedure steps (PAID and LATE) . 
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The ROLL Parameter (For MVT) 



ROLL=(x,y) 



declares whether the job step may be rolled out. Code YES if the 
step may be rolled out; code NO if the step iray not be rolled out. 



declares whether the job step may cause rollout of another job 
step. Code YES if the step may cause rollout of another job step; 
code NO if the step may not cause rollout of another job step. YES 
must be coded if you want additional main storage allocated to the 
step when additional main storage is required. 




Rules £or Coding 

1. If you code the ROLL parameter, both subparameters must be 
specified. 

2. If you have coded the ROLL parameter on the JOB statement, ROLL 
parameters coded on the job's EXEC statements are ignored. 

3. Code ROLL=(NO,YES) or ROLL=(NO,NO) if this step is part of a 
teleprocessing job that uses the Auto Poll option. If you allow 
the step to be rolled out, the step cannot be restarted properly. 

U. If the ROLL parameter is coded for PCP or MET, the parameter is not 
used, but is checked for syntax. 



When to Code the ROLL Parameter 

The ROLL keyword parameter should be coded if the job step may require 
more main storage than was requested in the REGION parameter. When you 
specify in the ROLL parameter that this job step iray cause rollout of 
another job step, an attempt is made to allocate additional storage if 
the step requires it. In order to allocate this additional space to a 
job step, another job step with a lower priority may have to be rolled 
out, i.e., temporarily transferred to secondary storage. 

The ROLL parameter should also be coded when you want control over 
whether the job step can be rolled out because of another step's need 
for additional main storage. If the ROLL parameter is not coded, the 
specification made in the PAI^^ parameter field in the cataloged 
procedure for the input reader is used. 

WHEN YOU CALL A CATALOGED PROCEDURE 

The ROLL parameter may be coded on the EXEC statement of a cataloged 
procedure step. If the job step calls a cataloged procedure, you may 
want to override all ROLL parameters in the procedure or only certain 
ROLL parameters. To override all ROLL parameters, code the ROLL 
parameter on the EXEC statement that calls the procedure. This 
establishes one rollout/rollin request for all the steps in the 
procedure. To override only certain ROLL parameters, code, on the EXEC 
statement that calls the procedure, ROLL.procstepname for each procedure 
step that you want to override. The rollout/rollin request will then 
pertain only to the named procedure step. 
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Examples o£ the ROLL Parameter 

1. //FILL EXEC PGM=PLUS,ROLL=(YES,YES) ,REGION=100K 

Specifies that this step may be rolled out and may cause rollout of 
another job step if this step requires more than lOOK of main 
storage. 

2. //UP EXEC PGM=Z165,ROLL={NO,YES) 

Specifies that this step may not be rolled out but may cause rollout 
of another job step. 

3. //STP4 EXEC BILLING, ROLL. LATE=(YES,lMO), ROLL. BILL=(NO, NO) 

Specifies that different rollout/rollin requests pertain to each of 
the named procedure steps (LATE and BILL) . 
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I The TIME Parameter (For MFT, MVT) 

■j (min 
\14U0 



TIME= j (minutes , seconds ) ) 



minutes 

specifies the maximum number of minutes the job step can use the 
CPU. The number of minutes must be less than 1440 (2U hours). 

seconds 

specifies the maximum number of seconds beyond the specified number 
of minutes the job step can use the CPU, or, if no minutes are 
specified, the maximum number of seconds the job step can use the 
CPU. The number of seconds must be less than 60. 

muo 

specifies that the job step is not to be timed. Code 1440 if the 
step may require use of the CPU for 24 hours or more or if the step 
should be allowed to remain in a wait state for more than the 
established time limit. 

Rules for Coding 

1. If the CPU time limit is given in minutes only, you need not code 
the parentheses. 

2. If the CPU time limit is given in seconds only, you must code a 
comma preceding the seconds to indicate the absence of minutes. 

3. If the TIME parameter is coded for PCP, the parameter is not used, 
but is checked for syntax. 



Specifying a Time Limit for a Job Step 

The TIME keyword parameter can be used to specify the maximum amount of 
time the job step may use the CPU. Two benefits of coding the TIME 
parameter are that it allows you to find out how long the step uses the 
CPU (CPU time used appears on the output listing) , and it helps limit 
the CPU time wasted by the step if it goes into a loop. Normally, a 
step that exceeds the specified time limit causes termination of the 
job. However, if the System Management Facilities option is included in 
the system and a user exit routine is provided, this routine can extend 
the time limit so that processing can continue. When the TIME parameter 
is not coded, a default time limit is assumed. The default is specified 
as a PARM parameter field in the cataloged procedure for the input 
reader . 

TIME LIMIT FOR WAIT STATES 

Since the job step can go into an extremely long wait state, the time a 
job step may remain in a wait state is limited. If the System 
Management Facilities option is included in the system, the installation 
determines this time limit. In this case, if the job step remains in a 
wait state for more than the established time limit, the job is 
terminated unless a user-provided exit routine extends the wait-state 
time limit for the step. If the System Management Facilities option is 
not included, the system automatically provides a 30-minute time limit 
for wait states; if the job step remains in a wait state for more than 
30 consecutive minutes, the job is terminated. 
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How to Eliminate Timing 

Certain applications require a job step to use the CPU for 24 hours or 
more. In this case you must eliminate timing by coding TIME=14U0. This 
specification should also be made when the step should be allowed to 
remain in a wait state for more than the established time limit. 



HOW THE JOE TIME LIMIT AFFECTS THE STEP TIME LIMIT 

The remaining job time may affect the amount of time the step can use 
the CPU. If the remaining CPU time for the job is less than the CPU 
time limit specified on the EXEC statement, the step can use the CPU 
only for the job's remaining CPU time. For example, if the job's 
remaining CPU time is 5 minutes and the step specifies a CPU time limit 
of 10 minutes, the step can only use the CPU for 5 minutes. 



WHEN YOU CALL A CATALOGED PROCEDURE 

The TIME parameter may be coded on the EXEC statement of a cataloged 
procedure step. If the job step calls a cataloged procedure, you may 
want to override all TIME parameters in the procedure or only certain 
TIME parameters. To override all TIME parameters, code the TIME 
parameter on the EXEC statement that calls the procedure. This applies 
a CPU time limit for the entire procedure, and nullifies any TIME 
parameters that appear on EXEC statements in the procedure. To override 
only certain TIME parameters, code, on the EXEC statement that calls the 
procedure, TIME.procstepname for each procedure step that you want to 
override. The CPU time limit will then pertain only to the named 
procedure step. 



Referenc e 

1. A discussion of the System Management Facilities option is 
contained in "Section 5: Task Management" in Concepts and 
Facilities . Information on user exit routines to be used with the 
System Management Facilities option is contained in the chapter 
"System Management Facilities" in System Programmer's Guide . 



Examples of the TIME Parameter 

1. //STEPl EXEC PGM=GRYS,TIME= (12,10) 

Specifies that the maximum amount of time the step can use the CPU 
is 12 minutes 10 seconds. 

2. //FOUR EXEC PGM=JPLUS,TIME= ( , 30) 

Specifies that the maximum amount of time the step can use the CPU 
is 30 seconds. 

3. //IMT EXEC PGM=CALC,TIME=5 

Specifies that the maximum amount of time the step can use the CPU 
is 5 minutes. 
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//LONG EXEC PGM=INVARL,TIME=1U40 

Specifies that the job step is not to be tirred. Therefore, the step 
may use the CPU cmd may remain in a wait state for an unspecified 
period of time. 

//STP4 EXEC BILLING, TIME. PAID=(U5, 30), TIME. BILL=(112, 59) 

Specifies that different time limits pertain to each of the named 
procedure steps. 
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Section IV: The DD Statement 



The DD (data definition) statement describes a data set that is to be 
used in a job step and specifies the input and output facilities 
required for use of ttie data set. Each data set to be used in a step 
requires a DD statement; all DD statements for a step follow that step's 
EXEC statement. Although all DD statement parameters are optional, a 
blank operand field is invalid, except when you are overriding DD 
statements that define concatenated data sets. (See "Overriding, 
Adding, and Nullifying Parameters on a DD Statement" in Appendix A of 
this publication.) You can include a maximum of 255 DD statements per 
job step. 



DD Statement Format 

j//ddname DD operands comments 




The DD statement consists of the characters //, in columns 1 and 2, and 
four fields - the name, operation (DD) , operand, and comments field. 



Rules £or Coding 

Follow the order listed below when coding the DD statement; 
1. Code the charactcirs // in columns 1 and 2. 



I-IO 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 


i|2|3|4|5|6|7|8|9|0 


11213 14151617181910 


l|2|3|4|5|6|7|8|9|0 


I|2|3l4|5|6|7|a|9|0 


l|2|3|4|5|6|7|8|9|0 


I|2|314|5|6|7|819|0 


I|2|3|4|5|617|8|9|0 


I12|3|4|5|6|7|8|9|0 


j/A 1 M . 1 < i 1 > 1 I M , , 1 1 1 1 . ; . 1 I 1 , > I < 1 1 . 1 1 i . . I .....> , 1 , i , . I i . <. . 1 . .1 . . |... < . . 1 . . . . 





2. Code a ddname, starting in column 3. (A ddname is not coded in two 
cases. These cases are described in the chapter "Assigning a 
Ddhame.") 



I-IO 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 
ir2T3T4l5l6T7T8l9r0 


l|2|3|4|5|6|7|8|9|0 


l|2|3|4|5|6|7|8|9|0 


I|2|3|4|5|617|8|9|0 


l|2|3|4|5|6|7|8|9|0 


I|2|3|4|5|6|7|8|9|0 


1.|2|3|415|6|7|819|0 


I|2|3|4|5|6|7|8i9|0 


UDM , , , , 


1 ' ' ' ' ' ' ' ' ' 1 






, , , , 1 , , , . 1 , , , , 1 , , , , 1 , , , , , , , , , 1 , , , , , 1 



3. Follow the ddnamei, or // if a ddname is not coded, with at least 
one blank. 

U. Code DD. 



I-IO 



11-20 



21-30 



31-40 



51-60 



61-70 



71-80 



1 1 |2|3l4|5l6|7|8l9lol I |2|3|4|5l6l7l8l9lol I |2 l3|4|5l6l7lal9lol I |2|3|4[5]6l 7|8l9lol I |2l3|4 |5|6|7|8|9|0lT|2|3|4|5|6|7|8|9|0| I |2]3|4|5|6|7|8|9|o| I |2l3|4l5|6|7l8|9lO 
\/.l.hhi\ .M , I , , , , I , , , , I , , ■ , I ■ , , , I I , , , , I , , , , I , ,. , . I I. ,. , ■ 4 x_,.,.,_. L-,^.., , .... (. . ..,._^L^^_ ^.i 



5. Follow DD with at least one blank 
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6. Code any desired positional parameter. 



I-IO 11-20 21-30 1 31-40 -ll-SO 


51-60 61-70 71-80 1 


ll2l3T4r5T6T7T8T9rO lT2r3T4l5T6r7l8[9|b 1 |2l3l4l5l6l7r8l9loTl r2r3T4l5l6r7l8r9lO lT2|3T4T5|6T7T8T9T0 


I2|3|4l5|6|7l8|9|0 1 |2|3|4l5l6l7l8l9|0 1 I2j3|4|5|6|7l8|9|0 


/./,Z),2),ii M DfXMm I .... \ .... I .... \ .. ~ . I .... \ .... 1 .... \ .... I .... I ... .\ .... \ .... i ... . 



7. Code any desired keyword parameters. Separate each parameter with 
a comma . 



-10 



1-20 I 21-30 ] 31-40 1 41-50 [ 51-60 [' 61-70 



kwM 



T2]3]4T5T6T7W9T0TlT2F3]4T5l6l7l8|9l6|ll2f3^^^^^^ 



71-80 



//Jj^^L^J)L^«A/^^.ii^A^Ai^.-!A.aBl.Xu^.J^^ x.,..J..a ,.,...., .J .._^^.^^.^...^.L..^._a4. 



8 . Code at least one blank . 

9. Code any desired comments. 

i-K) II 11-20 r 21-30 J 31-40 1 _„ 41-50 ^ J _ 51-60 1 6l-7'0 | 71-80 "" 

l2T3r4 T5T6l7T8 T9T0Tl[ 2T3T4T5|6T7l8^^^ 



.LL^4.\ >,2). i|HN,/Hi^i^,-Sj</ji^.5A.A.C.^,X:^^Ag.4Zv,,A4^^^ , ,^^_.^, 



Positional and Keyword Parameters 

There are two types of parameters that can be coded on the DD statement: 

Positional parameters , which must precede any keyword parameters. One 
of the following positional parameters may te coded on a DD statement: 

* 

DATA 

DUMMY 

These positional parameters are described in the following pages in the 
order listed above. 

Keyword parameters , which may be coded in any order. The following 
keyword parameters can be coded on a DD statement: 

AFF 

DCB 

DDNAME 

DISP 

DSN (see DSNAME) 

DSNAME 

LABEL 

OUTLIM - MFT, MVT 

SEP 

(continued on next page) 
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SPACE 

SPLIT 

SUBALLOC 

SYSOUT - PCP 

SYSOUT - MFT, MVT 

UCS 

UNIT 

VOL (see VOLUME) 

VOLUME 

These keyword parameters are described, after the positional parameters, 
in the order listed above. 



Sample DD Statements 



1. //DDA DD DSNAME=& &TEMP,UNIT=2 400, DISP= (NEW, PASS) 

2. //PRINT DD SYSOUT=F 

3. //IN DD DSNAME=ALLOC, DISP=(, KEEP, DELETE) ,UNIT=2 311, 
// VOLUME=SER==5U1382,SPACE=(CYL, (12,1)) 

U. //DWN DD * 
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Assigning a Ddname 

jV/ddnaine DD 

The ddname identifies a DD statement so that subsequent control 
statements and the data control block in the processing program can 
refer to it. The ddname must begin in column 3 and consist of 1 through 
8 alphameric and national (a, #, $) characters. The first character 
must be an alphabetic or national character. 

Each ddname within a job step should be unique. If duplicate ddnames 
exist in a step, allocation of devices and space and disposition 
processing are done for both DD statements; however, all references are 
directed to the first such DD statement in the step. 

There are several special ddnames that tell the system that you want 
to make use of particular facilities. Except for the ddname SYSCHK, do 
not use the special ddnames unless you want these facilities. These 
special ddnames are individually discussed following "Examples of Valid 
Ddnames . " 

Apart from the restricted use of certain special ddnames, tnere are 
two instances when you should not code a ddname at all: 

1. If a DD statement is to define a data set that is concatenated with 
a data set defined by a preceding DD statement. 

2. If the DD statement is the second or third consecutive DD statement 
that defines an indexed sequential data set. (Defining an indexed 
sequential data set on more than one DD statement is discussed in 
"Appendix C: Creating and Retrieving Indexed Sequential Data 
Sets.") 



WHEN ADDING OR OVERRIDING INFORMATION IN A CATALOGED PROCEDURE STEP 

If the job step uses a cataloged procedure, DD statements that follow 
the EXEC statement are used (1) to override parameters on the various DD 
statements in the procedure, and (2) to add new DD statements to the 
procedure. These modifications exist only for the duration of the job 
step; they do not change the procedure permanently. 

To make one of these modifications, each ddname must be qualified by 
a procedure step name, i.e., procstepname. ddname, as follows: 

1. To override parameters on a DD statement, code the name of the 
procedure step in which the DD statement appears, followed by a 
period, followed by the name of the DD statement that you want to 
override. 

2. To add DD statements to a procedure step, code the name of the 
procedure step in which you want to add the statement, followed by 
a period, followed by a ddname of your choosing. 

To supply a procedure step with data in the input stream, code the 
name of the procedure step that is to use the data, followed by a 
ddname. This ddname may be predefined in the procedure step by 
means of the DDNAME parameter. In this case, the ddname that 
follows the procedure step name is the name coded in the DDNAME 
parameter. Otherwise, you code a ddname of your choosing. 
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Examples of Valid Ddnames 



1. //DDl DD 

2. //#5863 DD 

3. //INPUT DD 
// DD 

Because the ddname is inissinq from the second DD statement, the data 
sets defined in these statements are concatenated. 

U . //PAYROLL . DAY DD 

If the procedure step named PAYROLL includes a DD statement named 
DAY, this statement overrides parameters on the statement named DAY. 
If the step does not include a DD statement named DAY, this 
statement is added to the procedure step for the duration of the job 
step. 

5. //STEPSIX.DD4 DD 
// DD 

You can define data sets that are to be concatenated and added to 
the procedure step by coding this sequence; that is by identifying 
the procedure step in which you want to add the statements, followed 
by a ddname of your choosing, on the first DD statement and omitting 
the ddname on the second DD statement. 
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Special Ddnames 

There are five special ddnames that tell the system you want to make use 
of a particular facility. The five ddnames and their functions are: 



• JOBLIB - 



• STEPLIB - 



this DD statement defines a private library that the 
system makes available for use by the job. 

this DD statement defines a private library that the 
system makes available for use by a job step. 



• SYSABEND - this DD statement defines a data set on which a dump 

can be written if the step abnormally terminates. The 
dump provided would include the system nucleus, the 
processing program storage area, and, possibly, a 
trace table. 

• SYSUDUMP - this DD Statement defines a data set on which a dump 

can be written if the step abnormally terminates. The 
dump provided would include only the processing 
program storage area. 

• SYSCHK - this DD Statement defines the checkpoint data set and 

is included when a deferred checkpoint restart is to 
occur . 
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JOBLIB 

Unless the system is told that the program you request on the EXEC 
statement resides in a private or temporary library, the system expects 
to find it in the system library (SYSl .LINKLIB) . One way to tell the 
system that a program resides in a private library is to follow the JOE 
statement with a DD statement namied JOBLIB. (The other way to tell the 
system that a program resides in a private library is to include, as one 
of the DD statements for a job step, a DD statement named STEPLIB. The 
STEPLIB DD statement is described under the next topic, "STEPLIB.") If 
you include a JOBLIB DD statement, each time you request a program the 
system first looks in the private library; if the system does not find 
the program there, the system looks for it in the system library. 

The parameters you code on the JOBLIB DD statement are determined by 
whether the library is cataloged. The parameters that must be coded 
when the library is cataloged and when the library is not cataloged are 
described under "When the Library Is Cataloged" and "When the Library Is 
Not Cataloged," respectively. In either case, how you code the DISP 
parameter is the same and is described in the topic "The DISP 
Parameter. " 

RULES FOR CODING THE JOBLIB DD STATEMENT 

1- The ddname must be JOBLIB. Never use the ddname JOBLIB except when 
you are defining a private library. 

2. The JOBLIB DD Statement must appear immediately after the JOB 
statement to which it pertains. 

3. A JOBLIB DD Statement cannot appear in a cataloged procedure. 

The DISP Parameter 

To make the private library available throughout the job, you must code 
the DISP parameter to specify the library's status and disposition. One 
of the following may be coded: 

1. DISP= (OLD, PASS) 

The library already exists and is kept at the end of the job. If 
you code DISP=OLD, the system assumes DISP=(CLD,PASS) . 

2. DISP=(SHR,PASS) 

The library already exists and is kept at the end of the job. The 
library may be used by other jobs that are executing concurrently. 
If you code DISP=SHR, the system assumes DISP=(SHR,PASS) . 

3. DISP= (NEW, PASS) 

The library is created and used in the job, and is deleted at the 
end of the job. 

U. DISP=(NEW,CATLG) 

The library is created, cataloged, and used in the job, and is kept 
at the end of the job. 
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when the Library Is Cataloged 

If the private library is cataloged, you must always code the DSNAME and 
DISP parameters. 

• The DSNAME parameter specifies the name of the private library. 

• The DISP parameter is either DISP= (OLD, PASS) or DISP=(SHR,PASS) . 

The other parameter you might code is DCB. 

• Code the DCB parameter if complete data control block information is 
not contained in the data set label. 

If you wish to refer to the private library in a later DD statement, 
code DSNAME=*.JOBLIB and the DISP parameter, DISP= (OLD, disposition) . 
(Do not assign a disposition of DELETE, because the library would then 
be deleted at the end of the job step and be unavailable for use during 
the remainder of the job.) If a later DD statement defines a data set. 
that is to be placed on the same volume as the private library, you can 
code VOLUME=REF=*. JOBLIB to obtain volume and unit information. 

When the Library Is Not Cataloged 

If the private library is not cataloged, you must always code the 
DSNAME, DISP, VOLUME, and UNIT parameters. 

• The DSNAME parameter specifies the name of the private library. 

• The DISP parameter is 

DISP=(OLD, PASS), DISP=(SHR, PASS) ,DISP= (NEW , PASS) , or 
DISP= (NEW , CATLG) . 

• The VOLUME parameter identifies the volume serial niimber. 

• The UNIT parameter specifies the device to be allocated to the 
library. 

The other parameter you might code is DCB. 

• code the DCB parameter if complete data control block information 
is not contained in the data set label . 

If you wish to refer to the private library in a later DD statement, 
code DSNAME=*. JOBLIB, VOLUME=REF=* .JOBLIB (or VOLUME=SER=serial number, 
UNIT=unit information), and the DISP parameter, DISP= (OLD, disposition) . 
(Do not assign a disposition of DELETE, because the library would then 
be deleted at the end of the job step and be unavailable for use during 
the remainder of the job) . If a later DE statement defines a data set 
that is to be placed on the same volume as the private library, you can 
code VOLUME=REF=*. JOBLIB to obtain volume and unit information. 

Concatenating Libraries 

You can arrange a sequence of DD statements that define different 
libraries. The libraries are searched in the order in which the DD 
statements appear. If the system library is not defined on one of these 
DD statements, it is searched last. 

To concatenate libraries, omit the ddname fromi all the DD statements 
defining the libraries except the first DD statement. The first DD 
statement must specify a ddname of JOBLIB, and the entire group must 
appear immediately after the JOB statement. 
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//PAYROLL 


JOB 


//JOBLIB 


DD 


//STEPl 


EXEC 


//STEP2 


EXEC 


//DDl 


DD 



//PAYROLL 


JOB 


//JOBLIB 


DD 


// 




//STEPl 


EXEC 


//STEP2 


EXEC 


//DDl 


DD 



When the Job includes a STEPLIB DD Statement 

If both JOBLIB and STEPLIB DD statements appear in a job, the STEPLIB 
definition has precedence, i.e., the private library defined by the 
JOBLIB DD statement is not searched for any step that contains the 
STEPLIB definition. If you want the JOBLIB definition ignored but the 
step does not require use of another private library, define the system 
library on the STEPLIB DD statement: 

//STEPLIB DD DSNAME=SYS1.LINKLIB,DISP=0LD 



Examples of the JOBLIB DD Statement 



DSNAME= PRIVATE . LIBU , DISP= (OLD , PASS) 

PGM=SCAN 

PGM=UPDATE 

DSNAME=* . JOBLIB , DISP= ( OLD , PASS ) 

The private library defined on the JOBLIB DD statement is cataloged. 
The statement named DDl refers to the private library defined in the 
JOBLIB DD statement. 

2. //PAYROLL JOB REGION=8 6K 

DSNAME=PRIV.DEPT58,DISP= (OLD, PASS) ,UNIT=2311, X 

VOLUME=SER=D58PVL 

PGM=DAY 

PGM=BENEFITS 

DSNAME=* . JOBLIB ,VOLUiyiE=REF=* . JOBLIB , DISP= (OLD , PASS ) 

The private library defined on the JOBLIB DD statement is not 
cataloged. The statement named DDl refers to the private library 
defined in the JOBLIB DD statement. 

MSGLEVEL=(1,1) 

DSNAi^E=GR0UP8. LEVELS, DISP=( NEW, CATLG) ,UNIT=2 311, X 

V0LUME=SER=1 U8 5 62 , SPACE= ( CYL ,(50,3,4)) 

PGM=DISC 

DSNAME=GR0UP8 . LEVELS (RATE) , DISP=0LD, X 

VOL=REF=* . JOBLIB 

PGM=RATE 

The private library defined on the JOBLIB DD statement does not 
exist yet; therefore, all the parameters required to define the 
private library are included on the JOBLIB DD statem.ent. The 
library is not created until STEPl when a new memiber is defined for 
the library. The system looks for the program named DISC in the 
system licrary; the system looks for the program named RATE first in 
the private library. 

DSNAWE=KRG.LIB12,DISP= (OLD, PASS) 
DSNAiyiE=GR0UP31 . TEST , DISP= (OLD , PASS ) 

DSNAME=PGMSLIB,UNIT=2311, X 

DISP= (OLD, PASS) ,VOLUME=SER=3U568 

Several private libraries are concatenated. The system searches for 
each program in this order: KRG.LIB12, GR0UP31.TEST, PGMSLIB, 
before searching SYSl.LINKLIB. 
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//TYPE 


JOB 


//JOBLIB 


DD 


// 




//STEPl 


EXEC 


//DDA 


DD 


// 




//STEP 2 


EXEC 



//PAYROLL 


JOB 


//JOBLIB 


DD 


// 


DD 


// 


DD 


// 





STEPLIB 

Unless the system is told that the program requested on the EXEC 
statement resides in a private or temporary library, the system expects 
to find it in the system library (SYSl.LINKLIB) . One way to tell the 
system that the program the job step needs resides in a private library 
is to include, as oiie of the DD statements for that step, a DD statement 
named STEPLIB. (The other way to tell the system that a program resides 
in a private library is to follow the JOB statement with a DD statement 
named JOBLIB. The JOBLIB DD statement is described in the previous 
topic, "JOBLIB.") If you include a STEPLIB DD statement, each time a 
program is requested the system first looks in the private library for 
the program the job step uses; if the system does not find the program 
there, it looks for the program in the system library. 

RULES FOR CODING THE STEPLIB DD STATEMENT 

1. The ddname must be STEPLIB. Never use the ddname STEPLIB except 
when you are defining a private library. 

2. A STEPLIB DD Statement can appear in any position among the DD 
statements for the step. 

3. The library defined on a STEPLIB DD statement can be referred to by 
or passed to later job steps in the same job. 

U. A STEPLIB DD Statement can appear in a cataloged procedure. 

5 . The parameters you code on the STEPLIB DD statement are determined 
by whether the library is cataloged, not cataloged, or passed by a 
previous job step. 

When the Library Is cataloge d 

If the private library is cataloged, you must always code the DSNAME and 
DISP parameters. 

• The DSNAME parameter specifies the name of the private library. 

• The DISP parameter specifies the library's status, either OLD or 
SHR, and its disposition. The disposition would be KEEP, UNCATLG, 
DELETE, or PASS, depending on how you want the library treated after 
its use in the job step. 

The other parameter you might code is DCB. 

• Code the DCB parcimeter if complete data control block information is 
not contained in the data set label . 

When the Library Is Not Cataloged or Passed 

If the private, librairy is not cataloged or passed, you must always code 
the DSNAME, DISP, VOLUME, and UNIT parameters. 

• The DSNAME parameter specifies the name of the private library. 

• The DISP parameter specifies the library's status, either OLD or 
SHR, and its disposition. The disposition would be KEEP, CATLG, 
DELETE, or PASS, depending on how you want the library treated after 
its use in the job step. 
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• The VOLUME parameter identifies the voluire serial number. 

• The UNIT parameter specifies the device to be allocated to the 
library. 

The other parameter you might code is DCB. 

• Code the DCB parameter if complete data control blcck information is 
not contained in the data set label. 

When the Library Is Passed By a Previo us Step 

If a private library has been assigned a disposition of PASS, a later 
job step can use the library when you code the DSNAME and DISP 
parameters on a STEPLIB DD statement. 

• The DSNAME parameter specifies either the name of the private 
library or a backward reference of the form *.stepnairie. STEPLIB. If 
the STEPLIB DD statement that assigned a disposition of PASS occurs 
in a cataloged procedure, the backward reference must include the 
procedure step name, i.e., *.stepname.procstepname. STEPLIB. 

• The DISP parameter specifies a status of OLD and a disposition. The 
disposition would be KEEP, CATLG, UNCATLG, DELETE, or PASS, 
depending on how you want the library treated after its use in the 
job step. 

Concatenating Librarie s 

You can arrange a sequence of DD statements that define different 
libraries. The libraries are searched in the order in which the DD 
statements appear. If the system library is not defined on one of these 
statements, it will be searched last for the program the job step uses. 

To concatenate libraries, omit the ddname from all the DD statements 
defining the libraries except the first DD statement. The first DD 
statement must specify a ddname of STEPLIB, and the entire group appears 
as part of the DD statements for a particular step. 

When the J o b Includes a JOBL IB DD Statement 

If both JOBLIB and STEPLIB DD statements appear in a job, the STEPLIB 
definition has precedence, i.e., the private library defined by the 
JOBLIB DD statement is not searched for any step that contains the 
STEPLIB definition. If you want the JOBLIB definition ignored but the 
step does not require use of another private library, define the system 
library on the STEPLIB DD statement: 

//STEPLIB DD DSNAME=SYS1.LINKLIB,DISP=0LD 



Examples of the STEPLIB DD Statement 

LABIU 

PGM=SPKCH 

DS NAME=PRIV. LIBS, DISP=( OLD, KEEP) 

PGM=TIL80 

DSNAME=PRIV.LIB13,DISP= (OLD, KEEP) ^*^* 

The private libraries defined in STEP2 and STEP3 are cataloged, 
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//PAYROLL 


JOB 


//STEPl 


EXEC 


//STEP 2 


EXEC 


//STEPLIB 


DD 


//STEP 3 


EXEC 


//STEPLIB 


DD 



//PAYROLL 


JOB 


//JOBLIB 


DD 


//STEPl 


EXEC 


//STEP 2 


EXEC 


//STEPLIB 


DD 


// 




//STEP 3 


EXEC 


//STEP 4 


EXEC 


//STEPLIB 


DD 


// 





dsname=lib5.group4,disp= (old, pass) 
proc=s]siz:l2 

PGM=SNAP10 

DSNAME=LIBRARYP, DISP= COLD, PASS ) , X 

UNIT=2311 ,VOLU]yiE=SER=55566 

PGM=A1530 

PGM=SNAP11 

DSNAME=* . STEP 2 . STEPLIB , X 

DISP=( OLD, KEEP) 

The private library defined in STEP2 is not cataloged. The STEPLIB 
DD statement in STEPU refers to the library defined in STEP2. Since 
a JOBLIB DD statement is included, STEPl and STEP 3 could execute 
programs from LIB5.GROUP4 or, if not found there, from SYSl.LINKLIB. 
STEP2 and STEP4 could execute programs from LIBRARYP or 
SYSl.LINKLIB. 



DSNAME=LIB5.GR0UPU,DISP= (OLD, PASS) 

PGM=SUM 

DSNAME=SYS1 . LINKLIB , DISP=OLD 

PGM=VARY 

PGM=CALC 

DSNAME=PRIV. WORK, DI3P= (OLD, PASS) 

DSNAME=LIBRARYA,DISP=( OLD, KEEP) , 

UNIT=2311,VOLUME=SER=a4U55 

DSNAME=LIB . DEPT88 , DISP= (OLD , KEEP) 

PGM=SHORE 



//PAYROLL 


JOB 


//JOBLIB 


DD 


//STEPl 


EXEC 


//STEPLIB 


DD 


//STEP2 


EXEC 


//STEP 3 


EXEC 


//STEPLIB 


DD 


// 


DD 


// 




// 


DD 


//STEPU 


EXEC 




STEP2 and STEPU can use programs contained in the private library 
named LIB5.GROUP4, which is defined in the JOBLIB DD statement. 
STEPl can use a program only from the system library, since the 
library defined on the STEPLIB DD statement is the system library 
and the JOBLIB definition is ignored. A concatenation of private 
libraries is defined in STEP3. The system searches for the program 
named CALC in this orders PRIV.WORK, LIBRARYA, LIB.DEPT88, 
SYSl.LINKLIB. If a later job step refers to the STEPLIB DD 
statement in STEP3, the system will search for the program in the 
private library named PRIV.WORK, and if not found there, in 
SYSl.LINKLIB. 
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SYSABEND and SYSUDUMP 

Each job step may contain one DD statement with a ddname of either 
SYSABEND or SYSUDUMP; if more than one is included, all but the first DD 
statement is ignored. These DD statements define a data set in which an 
abnormal termination dump can be written if the job step abnormally 
terminates. (Never use the ddname SYSABEND or SYSUDUMP unless you are 
defining a data set in which a dump can be written.) The dump provided 
when the SYSABEND DD statement is used includes the system nucleus, the 
processing program storage area, and a trace table, if the trace table 
option (PCP and MET only) was requested at system generation. The 
SYSUDUMP DD Statement provides only a dump of the processing program 
storage area. 

The parameters you code on one of these statements are determined by 
whether you want the dump written to a unit record device or stored and 
written at a later time. 

WRITING THE DUMP TO A UNIT RECORD DEVICE 

If you want the dump written to a unit record device, you code either 
the UNIT or SYSOUT parameter. 

• The UNIT parameter specifies the unit record device to which you 
want to write the dump, e.g., UNIT=1403. 

• The SYSOUT parameter specifies the output class through which you 
want the data set routed, e.g., SYSOUT=A. 

If the SYSOUT parameter is coded for MET or MVT, the dump is not 
routed directly to a system output device. Instead, the dump is stored 
on a direct access device and later written on a system output device. 
If you want control over which direct access device the dump is stored 
on, you can include the UNIT parameter. You can also control the amount 
of space allocated to the dump by including the SPACE paramieter. 
Otherwise, the system assigns a direct access device and space for a 
dump. (The device and space that the system, assigns are specified as 
PARM parameter fields in the cataloged procedure for the input reader.) 
If you may require a great deal of space for dumping, you should code 
the SPACE parameter, rather than using the default, and assign an 
adequate amount of space so that the dumping operation is not inhibited 
due to insufficient space. 

STORING THE DUMP 

If you want to store the dump and write it at a later time, the DD 
statement m.ust include the DSNAME, UNIT, VOLUME, and DISP parameters. 

• The DSNAME parameter specifies the name of the data set. 

• The UNIT parameter specifies the device to allocate to the data set. 

• The VOLUME parameter identifies the volum.e serial number. 

• The DISP parameter specifies the data set's status and disposition 
Since you want to store the data set, the data set's disposition ' 
must be either KEEP, CATLG, or PASS. 

If the dump is to be stored on a direct access device, you must code 
either the SPACE, SPLIT, or SUBALLOC parameter. 

• The SPACE, SPLIT, or SUBALLOC parameter specifies the amount of 
space you want allocated to the data set. 
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Reference 

1. Refer to the piiblication Prograimier's Guide to Debugging for 
information on how to interpret dumps . 



Examples of the SYSABEND and SYSUDUMP DD Statements 

1. //STEP 2 EXEC PGM=A 
//SYSABEND DD SYSOUT=A 

The SYSABEND DD statement specifies that you want the dump routed 
through the standard output class A. 

2. //STEP 3 EXEC PGM=B 

//SYSUDUMP DD SYSOUT=:F,SPACE=(TRK, (0 , 50) ) ,UNIT= (2311 , 3) 

The SYSUDUMP DD statement specifies that you want the dump routed 
through the output class F. If the job is run in a system with MFT 
or MVT, the dump is temporarily stored on the specified device. If 
the UNIT and SPACE parameters were not coded, the system would 
assign a direct access device and an estimate of space required for 
the dump. In the SPACE parameter, zero tracks are requested for the 
primary quantity; therefore, no space is allocated unless the step 
abnormally terminates. If the step abnormally terminates, space for 
a dump is allocated using the secondary quantity. Requesting 
multiple units increases the likelihood that one of the volumes 
mounted on these devices contains enough space to allocate the 
secondary quantity. 

PGM=PR0GRAM1 

DSNAME=DUMP,UNIT=2311,DISP=(,PASS,KEEP) , X 

VOLUME=SER=123U,SPACE=(TRK, (110,10)) 

PGM=PR0GRAM2 

DSNAME=* . STEPl . SYSABEND , DISP= (OLD , DELETE , KEEP ) 

The SYSABEND DD statements specify that you want the dump stored. 
The space request in STEPl is large (110 tracks) so that the dumping 
operation is not inhibited due to insufficient space; if STEPl does 
not abnormally terminate but STEP 2 does, the dump will be written 
using the space allocated in STEPl. In both steps, a conditional 
disposition of KEEP is specified. This allows storing of the dump 
if either of the steps abnormally terminates. If both of the steps 
are successfully executed, the second term of the DISP parameter 
(DELETE) in STEP2 causes the data set to be deleted and the space 
acquired for dumping to be freed. 

PGM=WWK 

DSNAME=DUMP,UNIT=2311,DISP=(, DELETE, X 

KEEP) „VOLUME=SER=54366,SPACE=(TRK, (80,10)) 

PGM=PRINT , COND=CNLY 

DSNAME=*. STEPl. SYSUDUMP, DISP= (OLD, DELETE) , X 

VOLUME=REF=* . STEPl . SYSUDUMP 

STEPl specifies that the dump is to be stored if the step abnormally 

terminates. Because COND=ONLY is specified in STEP2, the step is 

executed only if STEPl abnormally terminates. STEP2 uses a program 
that prints the dump. 




//STEPl 


EXEC 


//SYSABEND 


DD 


// 




//STEP 2 


EXEC 


//SYSABEND 


DD 



//STEPl 


EXEC 


//SYSUDUMP 


DD 


// 




//STEP 2 


EXEC 


//IN 


DD 


// 
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SYSCHK 

If CHKPT iracro instructions were executed during the original execution 
of your processing program, checkpoint entries were written on a 
checkpoint data set. If you plan to resubmit your job for restart and 
execution is to be restarted at a particular checkpoint, you miust 
include a DD statement named SYSCHK when you resubmit the job. The 
SYSCHK DD statement defines the data set on which the checkpoint entry 
was written. 

RULES FOR CODING THE SYSCHK DD STATEMENT 

1. The ddname must be SYSCHK. SYSCHK can be used as the ddname of 
other DD statements in jobs. 

2. The SYSCHK DD statement must immediately precede the first EXEC 
statement of the resubmitted job when restart is to begin at a 
checkpoint. (If the first EXEC statement is preceded by a DD 
statement named SYSCHK and restart is to begin at a step, the 
SYSCHK DD statement is ignored . ) 

3. If a JOBLIB DD statement is included, the SYSCHK DD statement must 
follow it. 

4. The RESTART parameter must be coded on the JOB statement; 
otherwise, the SYSCHK DD statement is ignored. 

5. The parameters you code on the SYSCHK DD statement are determined 
by whether the checkpoint data set is cataloged. 

When the Checkpoint Data S e t Is Ca taloge d 

If the checkpoint data set is cataloged, you must always code the DSNAME 
and DISP parameters. 

• The DvSNAME parameter specifies the name of the checkpoint data set. 

• The DISP parameter must specify or imply a status OLD and a 
disposition of KEEP, 

Other parameters you might code are VOLUME, UNIT, LABEL, and DCB. 

• If the checkpoint entry exists on a tape volume other than the 
first volume of the checkpoint data set, you must indicate this by 
coding the volume serial number or volume sequence number in the 
VOLUME parameter. (The serial number of the volume on which a 
checkpoint entry was written is contained in the console message 
printed after the checkpoint entry is written.) If you code the 
volume serial number, you must also code the UNIT parameter, since 
the system will not look in the catalog for unit information. 

» Code the LABEL parameter if the checkpoint data set does not have 
standard labels. 

• Code DCB=TRTCH=C if the checkpoint data set is on 7-track magnetic 
tape with nonstandard labels or no labels. 
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w hen the Checkpoint Data Set Is Not Cataloged 

If the checkpoint data set is not cataloqe^d, you roust always code the 
DSNAME, DISP, VOLUME, and UNIT parameters. 

• The DSNAME parameter specifies the name of the checkpoint data set. 
If the checkpoint data set is partitioned, do not include a meniber 
name in the DSNAME parameter. 

• The DISP parameter must specify or imply a status of OLD and 
disposition of KEEP. 

• The VOLUME parameter specifies the volume serial number of the 
volume on which the checkpoint entry resides. (The serial number of 
the volume on which a checkpoint entry was written is contained in 
the console message printed after the checkpoint entry is written.) 

• The UNIT parameter specifies the device to be allocated to the data 
set. 

Other parameters you might code are LABEL and DCB. 

• Code the LABEL parameter if the checkpoint data set does not have 
standard labels. 

• Code DCB=TRTCH=C if the checkpoint data set is on 7-track magnetic 
tape with nonstandard or no labels. 



Examples of the SYSCHK DD Statement 

1. //JOBl JOB RESTART= (STEPS, CK3) 

//SYSCHK DD DSNAME=CHLIB,UNIT=2311, ] 

// DISP=0LD,V0LUME=SER=4 56789 

//STEPl EXEC 

The checkpoint data set defined on the SYSCHK DD statement is not 
cataloged. 

2. //J0B2 JOB RESTART= (STEP2,NOTE2) 
//JOBLIB DD DSNAME=PRIV.LIB3,DISP= (OLD, PASS) 

//SYSCHK DD DSNAME=CHECKPTS,DISP= (OLD, KEEP) , ] 

// UNIT=2400,VOLUME=SER=U3 8291 

//STEPl EXEC 

The checkpoint data set defined on the SYSCHK DD statement is not 
cataloged. Note that the SYSCHK DD statement follows the JOBLIB DD 
statement . 

3. //J0B3 JOB RESTART=(*,CHECK4) 

//SYSCHK DD DSNAME=CHKPTLIB,DISP=OLD, 1 

// LABEL= ( , NSL) , DCB= ( TRTCH=C ) 

//STEPl EXEC 

The checkpoint data set defined on the SYSCHK DD statement is 
cataloged and has nonstandard labels. 
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The * Parameter 







//ddname DD 



specifies that the data following this statement is to be entered 
through the input stream for use by a processing program. 



Rules for Coding 

1. In PCP, there may be only one DD * statement per job step, and the 
DD * statement must be the last DD statement for the job step. 

2. In PCP, when you call a cataloged procedure, you can add only one 
DD * statement per procedure step. A DD * statement that you want 
to add to a procedure step must be the last of the overriding DD 
statements for that step. 

3. In PCP, the data must be followed by a delimiter statement (/*). 

U. In PCP, any other parameters coded on a DD * statement are not used 
but are checked for syntax. 

5. In MFT and MVT, there may be more than one DD * statement per job 
step. 

6. In MFT and MVT, when you call a cataloged procedure, you may add 
more than one DD * statement to a procedure step. 

7. In MFT and MVT, if the data is preceded by a DD * statement, a 
delimiter statement (/*) following the data is optional. 

8. In MFT and MVT, the DCB subparameters ELKSIZE and BUFNO have 
meaning when coded on a DD * statement. Any other parameters coded 
on a DD * statement are not used but are checked for syntax. 

9. A cataloged procedure cannot contain a DD * statement. 

10. Code the DATA parameter instead of the * parameter when the data 
contains job control statements. 




Defining Data in the Input Stream 

The input stream can be on a card reader, a magnetic tape, or, for MFT 
and MVT, a direct access device. 

If the EXEC statement for the job step specifies a program name, you 
can include the data for the job step in the input stream. If the EXEC 
statement for the job step calls a cataloged procedure, you can include 
the data for each procedure step in the input stream. 

If the processing program does not read all the data in an input 
stream, the remaining data is flushed without causing abnormal 
termination of the job. 
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WHEN YOU USE A SYSTEM WITH PCP 

For each job step there can be only cne DD * statement, and that 
statement must be the last DD statement for the job step. When you call 
a cataloged procedure, you can add a DD * statement to a procedure step, 
but the statement must be the last of the overriding DD statements for 
that step. In all cases, the data must be followed by a delimiter 
statement (/*) . 

The following rules apply when data is entered through an input 
stream: 

«• The input stream, must be on a card reader or magnetic tape. (Even 
if the input stream is on magnetic tape, the backspace operation is 
not permitted.) 

» The records must be unblocked, and 8 characters in length. 

• The characters in the records must be coded in BCD or EBCDIC. 



WHEN YOU USE A SYSTEM WITH MET OR MVT 

You can include several distinct groups of data in the input stream for 
a job step or procedure step. The system can recognize each group of 
data if you precede each group with a DD * statement, or follow each 
group with a delimiter statement (/*), or both. (if you leave out the 
DD * statement for a group of data, the system provides a DD * statement 
having SYSIN as its ddname.) 

The following rules apply when data is entered through an input 
stream: 

• The input stream can be on any device supported by QSAM. 

• The characters in the records must be coded in BCD or EBCDIC. 

Note : When the automatic SYSIN batching reader is used to read the 
input stream, a DD * statement does not appear in the output listing. 
Instead, an identically named DD statement describing the temporary data 
set created from the input data appears. 

The DCS Subparameters BLKSIZE and BUFN Q 

The input reader procedure causes data in the input stream to be written 
onto a direct access device so that the data can be retrieved rapidly 
when it is required by a processing program. As the data is written 
onto the direct access device, the data may be blocked. The block size 
and number of buffers used for blocking the data is established in the 
input reader procedure assigned to read the input stream. If you want 
shorter blocks than would be the case if the block size in the input 
reader procedure were assumed, you can specify the desired block size. 
(You cannot request larger blocks . ) 

To sp6icify the desired block size, code DCB=BLKSIZE=blocksize on the 
DD * statement. To decrease the number of buffers, include the DCB 
subparameter BUFNO, e.g., DCB=(BLKSIZE=80,BUFNO=1) . (When a job is 
submitted via remote job entry and the DCB subparameter BUFNQ is coded 
on a DD * statement, BUFNO is ignored.) 

BLKSIZE and BUFNO may be coded on a DD statement that contains the 
DDNAME parameter, which refers to another DD statement. If, in turn, 
the referenced DD statement defines data in the input stream, these DCB 
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subparameters are used to block the data. However, if the referenced DD 
statement contains its own DCB subparameters BLKSIZE and BUFNO, these 
values override those on the DD statement that contains the DDNAME 
parameter. 



Examples of the * Parameter 

1. //INPUTl DD * 

data 

/* 

Defining data in the input stream for any configuration, 

2. //STEP 2 EXEC PROC=FRESH 

//SETUP. WORK DD UNIT=2a00 ,LABEL= ( ,NSL) 
//SETUP. INPUTl DD * 

data 




/* 






//PRINT. FRM 


DD 


UNIT=180 


//PRINT. INP 


DD 


* 



data 



/* 

Defining data in the input stream for any control program. The 
input data defined by the DD statement named SETUP. INPUTl is for use 
by the cataloged procedure step named SETUP; the input defined by 
the DD statement named PRINT. INP is for use by the cataloged 
procedure step named PRINT. 

//INPUT2 DD *,DCB=(BLKSIZE=1600,BUFNO=2) 
data 



/* 

Defining data in the input stream for systems with MET or MVT. 
These DCB subparameters override those specified in the input reader 
procedure. 
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//INPUTS DD * 

data 
/* 

data 

/* 

//INPUTU DD * 

data 

/* 



Defining several groups of data in the input streait) for systems with 
MFT or MVT. 
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The DATA Parameter 

(//ddname DD DATA 

DATA 

specifies that the data following this statement is to be entered 
through the input stream for use by a processing program. This 
data contains job control statements (i.e., these statements have 
the characters // in columns 1 and 2«) 



Rules for Coding 

1. The data may not contain statements with /* in columns 1 and 2. 

2. In PCP, there may be only one DD DATA statement per job step, and 
the DD DATA statement must be the last DD statement for the job 
step. 

3. In PCP, when you call a cataloged procedure, you can add only one 
DD DATA statement per job step. A DD DATA statement that you want 
to add to a procedure step must be the last of the overriding DD 
statements for that step. 

4. In PCP, the data must be followed by a delimiter statement (/*). 

5. In PCP, any other parameters coded on a DD DATA statement are not 
used but are checked for syntax. 

6. In MFT and MVT, there may be more than one DD DATA statement per 
job step. 

7. In MFT and MVT, when you call a cataloged procedure, you may add 
more than one DD DATA statement to a procedure step. 

8. In MFT and MVT, each group of data must be preceded by a DD DATA 
statement and followed by a delimiter statement (/*) . 

9. In MFT and MVT, the DCB subparameters BLKSIZE and BUFNO have 
meaning when coded on a DD DATA statement. Any other parameters 
coded on a DD DATA statement are not used but are checked for 
syntax. 

10. A cataloged procedure cannot contain a DD DATA statement. 

11. The * parameter may be coded instead of the DATA parameter when the 
data does not contain job control statements. 



Defining Data in the Input Stream 

The input stream can be on a card reader, a magnetic tape, or, for MFT 
and MVT, a direct access device. 

If the EXEC statement for the job step specifies a program name, you 
can include the data for the job step in the input stream. If the EXEC 
statement for the job step calls a cataloged procedure, you can include 
the data for each procedure step in the input stream. 

If the processing program does not read all the data in an input 
stream, the remaining data is flushed without causing abnormal 
termination of the job. 
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WHEN YOU USE A SYSTEM WITH PCP 

For each job step there can be only one DD DATA statement, and that 
statement must be the last DD statement for the job step. When you call 
a cataloged procedure, you can add a DD DATA statement to a procedure 
step, but the statement must be the last of the overriding DD statements 
for that step. In all cases, the data must be followed by a delimiter 
statement (/*) . 

The following rules apply when data is entered through an input 
stream: 

• The input stream must be on a card reader or magnetic tape. (Even 
the input stream is on a magnetic tape, the backspace operation is 
not permitted.) 

» The records must be unblocked, and 80 characters in length. 

• The characters in the records must b*= coded in BCD or EBCDIC. 



WHEN YOU USE A SYSTEM WITH MET OR MVT 

You can include several distinct groups of data in the input stream for 
a job step or procedure step. The system can recognize each group of 
data only if you precede each group with a DD DATA statement and follow 
each group with a delimiter statement (/*). 

The following rules apply when data is entered through an input 
stream: 

• The input stream can be on any device supported by QSAM. 

• The characters in the records must be coded in BCD or EBCDIC. 

Note : When the automatic SYSIN batching reader is used to read the 
input stream, a DD DATA statement does not appear in the output listing. 
Instead, an identically named DD statement describing the temporary data 
set created from the input data appears. 

The DCB S ubparameters BLKSIZE and BUFN O 

The input reader procedure causes data in the input stream to be written 
onto a direct access device so that the data can be retrieved rapidly 
when it is required by a processing program. As the data is written 
onto the direct access device, the data may be blocked. The block size 
and number of buffers used for blocking the data is established in the 
input reader procedure assigned to read the input stream. If you want 
shorter blocks than would be the case if the block size in the input 
reader procedure were assumed, you can specify the desired block size. 
(You cannot request larger blocks.) 

To specify the desired block size, code DCB=BLKSIZE=blocksize on the 
DD DATA statement. To decrease the number of buffers, include the DCB 
subparameter BUFNO, e.g., DCB=(BLKSIZE=80,BUFNO=1) . (When a job is 
suhanitted via remote job entry and the DCB subparameter BUFNO is coded 
on a DD DATA statement, BUFNO is ignored.) 
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BLKSIZE and BUFNO may be coded on a DD statement that contains the 
DDNAME parameter, which refers to another DD statement. If, in turn, 
the referenced DD statement defines data in the input stream, these DCB 
subparameters are used to block the data. However, if the referenced DD 
statement contains its own DCB subparameters BLKSIZE and BUFNO, these 
values override those on the DD statement that contains the DDNAME 
parameter. 



Examples of the DATA Parameter 

1. //INPUTl DD DATA 

data 

/* 

Defining data in the input stream for any configuration. 

2. //STEP2 EXEC PROC=UPDATE 

//PREP.DDU DD DSNAME=A.B.C,VOLUME=SER=D88, X 

// UNIT=2311,SPACE=(TSK, (10 ,5) ) ,DISP= ( ,CATLG,DELETE) 

//PREP . INPUT DD DATA 

« 

data 

/* 

//ADD.BD6 DD SPACE=(TRK, (5, 1) ) 
//ADD. IN DD * 

data 

/* 

Defining data in the input stream for any configuration. The input 
defined by the DD statement named PREP. INPUT is for use by the 
cataloged procedure step named PREP. This data contains job control 
statements. The input defined by the DD statement named ADD. IN is 
for use by the cataloged procedure step anmed ADD. Since this data 
is defined by a DD * statement, it must not contain job control 
statements. 
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3. //INPUT2 DD DATA,DCB=(ELKSIZE=400,BUFNC=1) 



data 



//INPUTS DD DATA 



data 



/* 

Defining several groups of data in the input stream for systems with 
MFT or MVT. The DCB subparameters coded on the DD statement named 
INPUT2 used to block the data that follows that statement. 
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The DUMMY Parameter 

(^//ddname DD DUMMY 

DUMMY 

specifies that no devices or external storage space is to be 
allocated to the data set, no disposition processing is to be 
performed on the data set, and, for BSAM and QSAM, specifies that 
no input or output operations are to be performed on the data set. 



Rules for Coding 

1. You can code the DUMMY parameter by itself or follow it with all 
the parameters necessary to define a data set. 

2. If the DUMMY parameter is coded and an access method other than the 
basic sequential access method (BSAM) or queued sequential access 
method (QSAM) is requested to read or write the data set, a 
programming error occurs. 



What the DUMMY Parameter Doe? 

when you use either the basic sequential or queued sequential access 
method, the DUMMY parameter allows your processing program to execute 
without performing input or output operations on a data set. When the 
processing program asks to write a dummy data set, the write request is 
recognized, but no data is transmitted. When the processing program 
asks to read a dummy data set, an end-of-data-set exit is taken 
immediately. 

Besides bypassing input or output operations on a data set, the DUMMY 
parameter causes the UNIT, VOLUME, SPACE, and DISP parameters, when 
coded on the DD DUMMY statement, to be ignored (if coded, these 
parameters are checked for syntax). Therefore, no devices or external 
storage space is allocated to the data set and no disposition processing 
is performed on the data set. 

If you know that certain parts of a program "work" and need not be 
processed each time the job is submitted for testing, the DUMMY 
parameter can help save time. The DUMMY parameter can also be used to 
suppress the writing of data sets, such as output listings, that you do 
not need. 



Coding the DUMMY Parameter 

You can code the DUMMY parameter by itself or follow it with all the 
parameters you would normally code when defining a data set. However, 
in one case you must code another parameter after the DUMMY parameter: 
when certain DCB information, not supplied in the DCB macro instruction, 
is required for the processing program to execute successfully. For 
example, when an OPEN routine requires a BLKSIZE specification to obtain 
buffers, and BLKSIZE is not specified in the DCB macro instruction, you 
should supply this information by coding the DCB parameter after the 
DUMMY parameter. When a DD statement that overrides a procedure DD 
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statement contains the DUMMY parameter, all of the parameters coded on 
the procedure DD statement are nullified. 

When you want input or output operations performed on the data set, 
replace the DD statement that contains the DUMMY parameter with a DD 
statement that contains all of the parameters required to define this 
data set. When a procedure DD statement contains the DUMMY parameter, 
you can nullify it by coding the DSNAME parameter on the overriding DD 
statement. However, be sure the data set name is not NULLFILE. 
Assigning the name NULLFILE in the DSNAME parameter has the same effect 
as coding DUMMY. 

If you code DUMMY on a DD statement and a later DD statement in the 
same job refers to this DD statement when requesting unit affinity 
(UNIT=AFF=ddname) or volume affinity (VOLUME=REF=*. stepname.ddname) , the 
data set defined on the later DD statement is assigned a dummy status. 



Examples o£ the DUMMY Parameter 

1. //0UTPUT3 DD DUMMY,DSNAME=X.Y.Z,UNIT=2311, X 
// SPACE=(TRK, (10,2)) ,DISP= ( ,CATLG) 

This DD statement defines a dummy data set. The parameters coded 
with the DUMMY parameter are not used. 

2. //IN DD DUMMY, DCB=(BLKSIZE=800,LRECL=400,RECFM=FB) 

This DD statement defines a dummy data set. The DCB parameter is 
coded to supply information for the data control block that was not 
supplied in the DCB macro instruction. 

3. If you are calling a cataloged procedure that contains the following 
DD statement in STEP 4 

//IN DD DUMMY, DSNAME=ELLN,DISP=OLD,VOL=SER=11257,UNIT=2314 

you can nullify the effects of the DUMMY parameter by coding: 

//STEP4.IN DD DSNAME=ELLN 

U. If you are calling a cataloged procedure that contains the following 
DD statement in STEPl 

//TAB DD DSNAME=APP.LEV12,DISP=0LD 

you can make this DD statement define a dummy data set by coding: 

//STEPl. TAB DD DUMMY 

5. If you are calling a cataloged procedure that contains the following 
DD statement in a procedure step named LOCK 

//MSGS DD SYSOUT=A 

you can make this DD statement define a dummy data set by coding: 

//LOCK. MSGS DD DUMMY ,DISP=NEW 
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The AFF Parameter 

AFF=ddnaine 

ddname 

the name of an earlier DD statement in the same job step that 
requests processing of a data set on a separate channel from the 
one on which certain other data sets are being processed. 

Rules for Coding 

1. The DD statement that the AFF parameter refers to must contain the 
SEP parameter. 

2. If channel sepajpation is critical, use the UNIT parameter to 
specify a particular channel, using an absolute unit address or 
group name. (How to specify a particular channel is described in 
the chapter "The UNIT Parameter.") 

3. The AFF, SEP, DDNAME, and SYSOUT parameters are mutually exclusive 
parameters; therefore, vrhen SEP, DDNAME, or SYSOUT is coded, do not 
code the AFF parameter. 

OPTIMIZING CHANNEL USAGE 

The devices that the system allocates for data sets used in a job step 
are attached to channels. These channels transmit the data in the data 
sets from the device to the CPU. When two or more data sets are to be 
used in a job step, processing time may be shortened if the system 
transmits data over separate channels. 



Requesting Channel Separation 

The SEP and AFF parameters can be used to request channel separation. 
You list in the SEP parameter the names of up to eight earlier DD 
statements that define data sets from which channel separation is 
desired. (The SEP parameter is described in the chapter "The SEP 
Parameter" which appears later in this section.) Coding the AFF 
parameter is a shortcut method of requesting channel separation, since 
you list only one ddname and that ddname refers to an earlier DD 
statement in the same job step that contains the SEP parameter. The AFF 
parameter tells the system that you want the data set defined on this DD 
statement to have the same channel separation as the data set defined on 
the named DD statement. The AFF parameter does not tell the system that 
these two data sets are to be assigned to the same channel — the system 
will decide that based on what devices are available for allocation. 

In PCP, if the system finds it impossible in the current environment 
to satisfy the channel separation request, the request is ignored. 

In MFT and MVT, if the system finds it impossible in the current 
environment to satisfy the channel separation request, the system may 
try to alter the current environment through some operator action. The 
operator is given the option of bringing a device online, cancelling the 
channel separation request, or cancelling the job. In certain 
environments, the operator may also be able to tell the system to wait 
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for devices to become free. If you make a nonspecific request for a 
direct access volume and request channel separation, your request for 
separation may be ignored. This happens when the algorithm used to 
allocate data sets to devices is not able to select the device that 
would permit the desired channel separation. 

Requests for channel separation are ignored for any data sets that 
have been allocated devices by the automatic volume recognition (AVR) 
option. 

If it is essential that data be transmitted via a particular channel, 
you can specify an absolute \anit address or group namie (if the group of 
devices is associated with one channel) in the UNIT param.eter. 

If neither the SEP nor AFF paramieter is coded, any available channel, 
consistent with the UNIT parameter requirement, is assigned by the 
system. 



Example of the AFF Parameter 

EXEC PGM=CONVERT 

DSNAME=A . B . C , DISP=OLD 

DSNANjE=FILE,DISP=OLD,UNIT=2U00, X 

VOLUME=SER=54333 

UNIT=2400,SEP=(INPUT1,INPUT2) 

DSNAME=ALPHA , UNIT=TAPE , DISP= ( , KEEP ) , AFF=BUF 

The system attempts to assign the data sets defined by the DD 

statements EUF and OUTPUT to a channel other than the ones assigned 

to the data sets defined by the DD statements li^PUTl and INPUT2. ^^& 

The data sets defined by the DD statements BUF and OUTPUT may or may 

not be assigned to the same channel. The parameter 

SEP=C INPUT!, INPUT 2) could have been coded instead of AFF=BUF. 



//STEPl 


ex: 


//INPUTl 


DD 


//INPUT 2 


DD 


// 




//BUF 


DD 


//OUTPUT 


DD 
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The DCB Parameter 



DCB=(list of attributes) 
1 DCB= ( j dsname 

I *.stepnaine.ddname 

' * . stepnaire . procstepname . ddnaire / 



[,list of attributes]) 



list of attributes 

those DCB keyword subparameters that describe the data set and are 
needed to complete the data control block. DCB keyv?ord 
subparameters are listed in this chapter under "Glossary of DCB 
Subparameters, " 

dsname 

specifies that the system is to copy DCB information from the data 
set label of a cataloged data set named "dsname." The cataloged 
data set must reside on a direct access volume and the volume must 
be mounted before execution of the job step. 

* . ddname 

specifies that the system is to copy DCB information from an 
earlier DD statement in the same job step named "ddname." 

* . stepname . ddname 

specifies that the system is to copy DCB information from a DD 
statement named "ddname/' which appears in an earlier job step 
named "stepname." 

* , stepname . procstepname . ddname 

specifies that the system is to copy DCE information from a DD 
statement named "ddname," which appears in a procedure step named 
"procstepname"; the procedure step is part of a cataloged procedure 
that was called by an earlier jobstep named "stepname." 



Rules for Coding 

1. Separate each DCB keyword subparameter with a comma. 

2. If the DCB parameter value consists of only one keyword 
subparameter, a data set name, or a backward reference, you need 
not enclose it in parentheses. 

3. All DCB subparameters, except BLKSIZE and BUFNO, are mutually 
exclusive with the DDNAME parameter; therefore, when the DDNAME 
parameter is coded, do not code any DCE subparameters except 
BLKSIZE and BUFNO. The DCB subparameters BLKSIZE and BUFNO have 
meaning when coded with the DDNAME parameter. 




Completing the Data Control Block 



Each data set that is to be read or written must have a data control 
block associated with it. The data control block is originally 
constructed in the processing program by a DCB macro instruction. This 
data control block can be completed when the DCB macro instruction is 
issued or at execution time through the DCB parameter on the DD 
statement and the data set label, if one exists. 
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when more than one source is used to coiriplete the data control block, 
a merging process takes place (see Figure 4): first, information coded 
with the DCB macro instruction is placed in the data control block; 
then, information coded on the DD statement is placed in unfilled 
sections of the data control block; and, finally, information in the 
data set label, if one exists, is placed in still unfilled sections of 
the data control block. (DCB information may also be provided by 
default options assumed in the OPEN macro instruction and by your 
program, either before the data set is opened, by using the DCBD macro 
instruction, or in the DCB exit routine. Refer to the chapter 
"Interface With the Operating Systeir" in Supervisor and Data Management 
Services publication and Supervisor and Data Management Macro 
Instructions publication for details.) 




Step 1 



Step 2 



Step 3 



Figure 4. How the Data Control Block Is Filled 

DCB Macro Instruction 

The DCB macro instruction includes information about the data that is 
unlikely to change each time the processing program is executed. Also, 
it includes any information that is not related to the DCB parameter and 
the data set label (e.g., MACRF, DDNAME, EXLST) . 
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DCB Parameter 

The DCB parameter is coded on the DD statement and includes all the 
information that is not specified by any other source. How to specify 
DCB information on the DD statement is described in "Specifying DCB 
Information on the DD Statement." 

Data set Label 

If the data set already exists and has standard labels, certain 
information is contained in the label that, can be used to complete the 
data control block. For tape, the data set label can contain the data 
set's record format, block size, logical record length, tape recording 
density, and, for seven-track tape, tape recording technique. For 
direct access, the data set label can contain the data set's 
organization, record format, block size, logical record length, and if 
the data contains keys, the key length and relative key position. 

Specifying DCB Information on the DD Statement 

The DCB parameter must be coded on the DD statement unless the data 
control block is completed by other sources. There are several ways of 
specifying DCB information on the DD statement. You can: 

• Supply all pertinent DCB keyword subparameters on the DD statement. 

• Tell the system to copy DCB information from the data set label of 
an existing cataloged data set. 

• Tell the system to copy DCB information from an earlier DD statement 
in the same job. 

SUPPLYING DCB KEYWORD SUBPARAMETERS 

The DCB information required to complete the data control block can be 
listed as keyword subparameters in the DCB parameter; subparameters are 
separated by commas. If the processing program and the DCB parameter 
supply the same subparameter, the subparameter on the DD statement is 
ignored. Valid DCB keyword subparameters and the values that can be 
assigned to them are listed in this chapter under "Glossary of DCB 
Subparameters . " 

COPYING DCB INFORMATION FROM A DATA SET LABEL 

To save time in coding the DCB parameter, you can tell the system to 
copy the DCB information from the data set label of a cataloged data set 
on a currently mounted direct access volume. The data set must have 
standard labels. A permanently resident volume is the most likely place 
from which to copy such information because it is always mounted. Code 
in the DCB parameter the data set name of the cataloged data set. The 
name you code cannot contain special characters, except for periods used 
in a qualified name. 

The following DCB keyword subparameters can be copied from the data 
set label: DSORG, RECFM, OPTCD, BLKSIZE, LRECL, KEYLEN, and RKP. The 
volume sequence number and expiration date of the cataloged data set are 
also copied unless you specify these in the DD statement. If you code 
any DCB keyword subparsuneters following the name of the cataloged data 
set, these subparameters override any of the corresponding subparameters 
that were copied. Valid DCB keyword subparameters and the values that 
can be assigned to them are listed in this chapter under "Glossary of 
DCB Subparameters." 
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COPYING DCB INFORMATION FROM AN EARLIER DD STATEMENT 

Another way to save time in coding the DCB paraireter is to tell the 
system to copy the DCB information from an earlier DD statement in the 
same job. The earlier DD statement can he contained in the same job 
step, an earlier job step or cataloged procedure step. If you code any 
DCB keyword subparameters following the reference to the BD statement, 
these subparameters override any of the corresponding subparameters that 
were copied. If the DD statement defines an existing data set and 
contains the DCB parameter, the system copies those subparameters from 
the earlier DD statement that were not previously specified for the 
existing data set. Valid DCE keyword subparameters and the values that 
can be assigned to them are listed below. 



Glossary of DCB Subparameters 

This glossary lists the keyword subparameters that you can code in the 
DCB parameter on a DD statement, their definitions, and the values that 
can be assigned to them. Across from each subparameter is a list of the 
access methods that use the subparameter. 

Certain required subparameters cannot be coded in the DCB parameter, 
but must be coded in the DCB macro instruction. These subparameters are 
described in the Supervisor and Data Management Macro Instructions 
publication. 



BFALN= 



{1} 



Can be used with BBAM, BISAM, 
BPAM, ESAM, EXCP, QISAM, gSAM 



Specifies the boundary alignment of each buffer as follows: 

F — each buffer starts on a fullword boundary that is not also a 

doubleword boundary. 
D — each buffer starts on a doubleword boundary. 

If not specif ed by any source, doubleword boundary alignment (D) is 
assumed. 

Note for QSAM ; Buffer alignment information must be supplied from 
the same source as the type of buffering (EFTEK) information or 
both must be omitted. 



EFTEK= 



I I 



S 
E 
D 
A 
R 



Can be used with EXCP, QSAM, BTAM 



Specifies the type of buffering to be used by the control program 
as follows : 

For EXCP: 

S -- simple buffering. 
E — exchange buffering. 
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For QSAM: 

S — simple buffering. 

E — exchange buffering (track overflow cannot be specified in the 

RECFM subparaineter) . Exchange buffering cannot be used v»ith 

variable-length blocked or spanned records . 

A — record area buffering. In the locate mode with 

variable-length spanned records, the control program reads and 
writes entire logical records rather than segments. 

If neither is specified by any source, simple buffering (S) is 
assumed. 

Note for QSAM ; The type of buffering information must be supplied 
from the same source as the boundary alignment (BFALN) information 
or both must be omitted. 

For BTAM: 

D — dynamic buffering. If dynamic buffering is specified, a 
buffer pool must be defined. 

For BDAM or BSAM: 

R — record buffering. For writing records in the create BDAM 

mode, this specification allows a logical record to span one 
or more tracks. For reading a data set, segments without keys 
are offset in the buffer by the key length. This means that 
the actual data starts in the same place in the buffer by the 
key length. This means that the actual data starts in the 
same place in the buffer for each read. 

BLKSIZE=block size Can be used with BDAM, BPAM, 

BSAM, QISAM (output only) , 

QSAM 

Specifies the maximum length, in bytes, of a block. The maximum 
length that can be specified is 32,760. 

• If RECFM=F, then BLKSIZE must be > logical record length. 

• If RECFM=FB, then BLKSIZE must be an integral multiple of the 
logical record length. 

• If RECFM=V, then BLKSIZE must be > (maximum block size + 4). 

• If RECFM=VB, then BLKSIZE must be n times (logical record length 
+ 4) ; where n is the niamber of logical records in the block. 

Note for QISAM ; The block size that is specified must be at least 
10 bytes less than the number of data bytes available on one track 
of the allocated direct access device. Block size information is 
required only when creating a data set containing blocked records. 

Note for BDAM, BPAM, BSAM, QSAM ; If you code the BLKSIZE 
subparameter in the DCB macro instruction or on a DD statement that 
defines an existing data set and the data set has standard labels, 
the subparameter overrides the block size specified in the label. 

Note for BSAM and QSAM with RECFM=FB ; If the BLKSIZE subparameter 
on a DD statement for a SYSOUT data set (an output data set being 
routed through the output stream) is not an integral multiple of 
and larger than the logical record length (LRECL) , the block size 
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wilJ. be adjusted to the nearest lower multiple of the logical 
record length (LRECL) . 



BUFL=buffer length 



Can be used with BDAM, BISAM, 
BPAM, BSAM, EXCP, QISAM, QSAM 



Specifies the length, in bytes, of each buffer in the buffer pool. 
The maxiinuin length is 32,760 bytes. Requirements for supplying 
buffer length information vary with the different data 
organizations and access methods as follows: 

BDAM — required only if dynamic buffering is specified in the 
MACRF subparameter of the DCB macro instruction. 

BPAM, BSAM, and QSAM — optional. If omitted and the control 

program acquires buffers automatically, the block size and 
key length information is used to establish buffer length. 
If card image is specified (MODE=C), BUFL=160 must be 
specified. 

BISAM and QISAM — not required if the control program acquires 

buffers automatically or if dynamic buffering is specified. 
(For BISAM, dynamic buffering is specified in the MACRF 
subparameter of the DCB macro instruction) . 



BUFNO=number of buffers 



Can be used with BEAM, BISAM, 
BPAM, BSAM, BTAM, EXCP, CISAM, 
QSAM 



Specifies the number of buffers to be assigned to the data control 
block; the maximum number is 255, but the actual number allowed may 
be less than 255 because of limits established when the system was 
generated. Requirements for coding the BUFNO subparameter are as 
follows : 



Method of Obtaining the 
Buffer Pool 

BUILD macro instruction (BDAM, 
BISAM, BPTiM, QISAM, QSAM) 

GETPOOL macro instruction (BDAM, 
BISAM, BPAM, BSAM, QISAM, QSAM) 



Automatically (BPAM and BSAM) 
Automatically (QISAM and QSAM) 

Dyneimic buffering (BDAM and BISAM) 



Requirement for Indicating 
Number of Buffers 

Must be specified. 



Control program uses the 
number specified in the 
GETPOOL macro instruction. 

Must be specified. 

Optional; if not specified, 
two buffers are obtained. 

Optional; if not specified, 
two buffers are obtained. 



BUFRQ=nurnber of buffers 



Can be used with QTAM 



Specifies the number of buffers to be requested in advance for the 
GET macro instruction. The maximum number is 255. If not 
specified by any source or if a value cf less than 2 is specified, 
2 is assumed. For information on calculating BUFRQ, refer to the 
publication IBM Svstem/360 Operating System; Telecommunications 
Access Method Message Control . GC30-2005. 
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CODE= 


A 




B 




C 


4 


F - 




I 




N 




T 
to ^ 



Can be used with BSAK, EXCP, QSAM 



Specifies the paper tape code in which the data is punched. 

A — USASCII (8 track). 

B — Burroughs (7 track) . 

C — National Cash Register (8 track). 

F — Friden (8 track) . 

I — IBM BCD perforated tape and transmission code (8 track). 

N — No conversion required. 

T — Teletype (5 track). 

If not specified by any source, I is assumed. 

The subpararoeters CODE, KEYLEN, MODE, PRTSP, STACK, and TRTCH are 
mutually exclusive subparameters. Therefore, if CODE is coded, do 
not code any of these other subparameters. 

CPRI= (r) Can be used with QTAM 



Specifies the relative priority to be given to sending and 
receiving operations, as follows: 

R — receiving has priority over sending. An output message is 
sent on a given line only during a polling interval. 

E — receiving and sending have equal priority. After each full 
polling sequence on a given line, all output messages queued 
for that line are transmitted. 

S — sending has priority over receiving. For nonswitched lines 
after QTAM polls a terminal on a line, the line is m.ade 
available for outgoing messages, and the next terminal is 
polled only when there are no output messages in the queue for 
the line. For Auto Poll lines, the line is made available for 
outgoing messages after a message ending in EOT is received by 
a terminal on the line, or when the end of the polling list is 
reached. S must be specified for IBM 2740 Communications 
Terminals Types I and VI, and if the line group includes IBM 
2740 Model 2 terminals. 

If this subparameter is not specified by any source, CPRI=S is 
assumed. 

This subparameter must be omitted if this line group consists of 
switched lines. 

For WTTA lines : 

R or E — output messages are sent when there is no traffic over 

the line, after an EOT character has been received, or after a 
time-out has occurred. 

S — output messages are sent when Inhere is no traffic over the 
line, after an EOT or EOM character has been received, or 
after a time-out has occurred. 
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CYLOFL=number 



Can be used with QISAM 
(output only) 



Specifies the number of tracks on each cylinder to hold the records 
that overflow from other tracks on that cylinder. The maximum 
number is 99. 



DEN= 



Can be used with BSAW, EXCP, QSAM 



Specifies the magnetic tape density in number of bits-per-inch used 
to write a data set, as follows: 

r T r T 

|DEN=|7 track I 9 track | 



200 I 
556 I 
800 I 800 
I 1600 



If not specified by any source, 8 00 bits-per-inch is assumed for 
7-track tape, 800 bits-per-inch for 9-track tape without dual 
density, and 1600 bits-per-inch for 9-track tape with dual density 
or phase-encoded drives. 

For 7-track tape, all information on the reel must be written in 
the same density (i.e., labels, data, tapemarks) . Do not specify 
DEN for a SYSOUT data set. 



DSORG=data set organization 



can be used with BDAirl, BISAiyi, 
BPAM, BSAM, BTAM, EXCP , GAM, 
QISAM, QSAM, QTAM 



Specifies the organization of the data set and whether the data set 
contains any location-dependent information that would make the 
data set unmovable (U) . The values that can be used are as 
follows : 



DA - 
DAU 
CQ - 



CX - 
GS - 
IS ■ 
ISU 

m • 



PO ■ 
POU 
PS ■ 
PSU 



- Direct access 

- Direct access unmovable 

- Direct access message queue or the checkpoint for a 
message control program. If this subparameter is not 
specified by any source, the telecommunications job, when 
executed, is terminated, 

- Communications line group 

- Graphic data control block 

- Indexed sequential 

-- Indexed sequential unmovable 

- Data control block governing message transfer to or from 
a telecommunications message processing queue. If this 
subparameter is not specified by any source, the 
telecommunications job, when executed, is terminated. 

- Partitioned organization 

- Partitioned organization unmovable 

- Physical sequential 

- Physical sequential unmovable 



The values used with each access method are listed below. 
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DSORG must always be coded in the DCB macro instruction, and, with 
certain access methods, must be coded on the DD statement. 



BDAM — DA or DAU (PS or PSU when creating the data set) . The 
DSORG subparameter must be coded on the DD statement 
that defines the data set. When creating the data 
set, the DSORG subparameter must be coded as DA or DAU 
on the DD statement that defines the data set and PS 
or PSU in the DCB macro instruction. 

BISAM — IS; must be coded on the DD statement. 

BPAM — PO or POU 

BSAM — PS or PSU 

BTAM — CX 

EXCP — PS, PO, DA, or IS 

GAM — GS 

QISAM — IS or ISU (ISU can be specified only when creating 
the data set) , The DSORG subparameter must be coded 
on the DD statement that defines the data set. 

QSAM — PS or PSU 

QTAM — MQ, CQ, or CX 




EROPT=(ACC) 
]SKP[ 

(abe) 



Can be used with QSAM 



Specifies the option to be executed if an error occurs in writing 
or reading a record, as follows: 

ACC — Accept the block causing the error. 

SKP — Skip the block causing the error (implies RELSE) . 

ABE — Cause abnormal end of task. 

If the subparameter is not specified by any source, ABE is assumed. 



GNCP= number 



Can be used with GAM 



Specifies the maximum number of input/output macro instructions 
that will be issued before a WAIT macro instruction. The value of 
GNCP must be from 1 to 99 at execution time. If the value of GNCP 
is not specified by any source, a value of 1 is assumed. 



HI7^CHY= 



{?} 



Can be used with EDAM, EISAM, 
BPAM, BSAM, EXCP, QISAM, QSAM 



Specifies the storage hierarchy in which the buffer pool is to r»e 
formed as follows: 

— forms the pool from available space in processor storage. 

1 — forms the pool from available space in IBM 2361 Core 

Storage. 

If the HIARCHY subparameter is not specified by any source, and if 
a hierarchy designation is not supplied by the GETPOOL macro 
instruction, hierarchy is assumed. 

The buffer pool is formed within the indicated hierarchy, or in the 
case of MET or MVT, in the user partition or region in that 
hierarchy. If space is unavailable within the hierarchy specified, 
the task is abnormally terminated. 
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INTVL=nuinber Can be used with QTAM 

Specifies the polling interval (i.e., the nuinber of seconds of 
intentional delay between passes through a polling list) for the 
lines in this line group. After all the terminals in a polling 
list for a given line have been polled (beginning to end) , a delay 
equal to the number of seconds specified in this subparameter 
occurs before polling is restarted at the beginning of the list. 
The number specified must not be greater than 255. 

If this subparameter is not specified by any source, INTVL=0 is 
assumed. This subparameter must be omitted if the line group 
consists of switched lines, WTTA lines, or if the Auto Poll feature 
is used. 

KEYLEN= number Can be used with BDAM, BPAM, 

BSAM, EXCP, QISAM (output only) 

Specifies the length, in bytes, of the keys used in the data set. 
Except for QISAM, the keys are associated with blocks on direct 
access devices; the keys for indexed sequential data sets are 
associated with records. The maximum key length is always 255 
bytes . 

The subparameters KEYLEN, CODE, MODE, PRTSP, STACK, and TRTCH are 
mutually exclusive subparameters. Therefore, if KEYLEN is coded, 
do not code any of these other subparameters. 

Not e for BDAM : If standard labels are used, the key length 
information can be supplied from the data set label for an existing 
data set. If a key length is not supplied by any source, no input 
or output requests that require a key may be issued. 

Note for BPAM and BSAM ; If standard labels are used, the key 
length information can be supplied from the data set label for an 
existing data set. If a key length is not supplied by any source 
before the OPEN macro instruction is issued, a length of zero (no 
keys) is assumed. 

Note for QISAM ; For an existing data set with standard labels, the 
key length can only be supplied from the data set label. 

LIMCT=number Can be used with BDAM 

Specifies the number of blocks, if relative block addressing is 
used, or the number of tracks, if relative track addressing is 
used, that are to be searched for a block or available space when 
the extended search option (OPTCD=E) is specified. The number may 
equal or exceed the number of blocks or tracks in the data set, in 
which case the entire data set is searched. 

If the extended search option is not specified, the LIMCT 
subparameter is ignored. 

LRECL=n umber Can be used with BPAM, BSAM, 

QISAM (output only) , QSAM 

Specifies the actual or maximum length, in bytes, of a logical 
record. The record length is required for fixed-length and 
variable-length records; for variable-length records, the maximum 
record length should be specified. The length cannot exceed the 
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block size (BLKSIZE) value except for variable-length spanned 
records. 

• If RECFM=V or VB, then LRECL must be equal to the rriaximuin 
record length + U. 

• If RECFM=F or FE , then LRECL must be equal to the logical 
record length. 

• If RECFM=U, then LRECL should be oiritted. 

Note for BPAM ; The record length is required for fixed-length 
records only. 

Note for BSAM ; The record length can be omitted from all sources, 
in which case the block size specification (BLKSIZE) is used. For 
variable-length spanned records (VS or VBS) processed under BSAM, 
if logical record exceeds 32,756, specify LRECL=X. 

Note for QISAM : For unblocked records, with a relative key 
position (RKP) of zero, the record length includes only the data 
portion of the record. The record length can be specified only 
when creating the data set. 

Note for QSAM : For variable-length spanned records (VS or VBS) 
processed under QSAM (locate mode) , if logical record exceeds 
32,756, specify LRECL=X. 

MODE= iC\ Can be used with BSAM, EXCP, QSAM 




{b} 



Specifies the mode of operation to be used with a card reader, a 
card punch, or a card-read punch, as follows: 

C — the card image (column binary) mode. 
E — the EBCDIC mode. 

If this information is not supplied by any source, E is assumed. 

The subparameters MODE, CODE, KEYLEN, PRTSP, and TRTCH are mutually 
exclusive subparameters. Therefore, if MODE is coded, do not code 
any of these other subparameters. 

NCP=number Can be used with BISAM, BPAM, 

BSAM 

Specifies the maximum number of READ or WRITE macro instructions 
issued before a CHECK macro instruction is issued. The maximum 
number allowed is 99 , based on limits established when the system 
was generated. If chained scheduling is used, NCP miust be 
specified as more than 1. 

If not specified by any source, 1 is assumed. 

NTM=number Can be used with QISAM 

Specifies the number of tracks to be used for a cylinder index. 
When the specified number of tracks has been filled, a master index 
is created. This information is required only when the master 
index option (OPTCD=M) is selected. 

If not specified by any source and OPTCE=M is specified, the master 
index option is ignored. 
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Can be used with ED^M, BPAM, 

BSAM, EXCP, QISAM (output only), 

QSAM 



OPTCD= I A 

B 
C 
E 
F 
H 
I 
L 
M 
O 
R 
T 
U 
W 
Y 
Z 

Specifies the optional services to be perfcrired by the control 
proqrairi. All optional services must iae requested by the sairie 
source. The characters may be coded in any order and, when used in 
combination, no commas are permitted between characters. 

A — Actual device addresses are tc be presented ("block 

address" operand) in READ and WRITE macro instructions. 
For EDAM, R requests the same option as A, and either can 
be coded . 

B — Requests that end-of-file recoqnition be disregarded for 
tapes . 

C — Requests that chained scheduling be used. 

E — An extended search (more than one track) is to be 

performed for a block or available space. (The LIMCT 
subparameter must also be specified; otherwise, this 
option is ignored.) 

F -- Feedback may be requested in READ and WRITE macro 

instructions and the device address returned is to be of 
the form presented to the control program. 

H — Requests nopper empty exit for Optical Readers (BSAM) . 

I — Requests that the control program use the independent 
overflow areas for overflow records. 



L — Requests that the control program delete records that 

have a first byte of all cnes; records so marked may ne 
deleted when space is required for new records. Do not 
specify this option for blocked records if RKP=0. 

M — Requests that master indexes be created as required, 
according to the information in the NTi^j subparameter. 
This option is ignored if the subparameter iNTiyi=number is 
not specified. 

O — Requests online correction for Optical Readers (QSAM) . 

R — For BDAM, actual device addresses are to be presented 
("block address" operand) in READ and WRITE macro 
instructions . 

For QISAM, requests the control program to place 
reorganization criteria information in the RORGl , R0RG2 , 
and RORG3 fields of the data control block. This option 
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is provided whenever the OPTCD subparaitieter is omitted 
from all sources. 

T — Requests user totaling facility. 

U — Only for 1403 printers with th6 Universal Character Set 
features Unblocks data checks and allows analysis by an 
appropriate error analysis (SYNAD) routine. If U is 
omitted, dat<i checks are blocked (not recognized as 
errors) . 



W — Requests a validity check for write operations on direct 
access devices. If the device is a 2321 data cell, 
validity checking is always performed, whether requested 
or not. 

Y — Requests that the control program use the cylinder 
overflow areas for overflow records. 

Z — Only for input on magnetic tape: Requests the control 
program to shorten its normal error recovery procedure. 
When Z is specified, a data check is . considered permanent 
after five unsuccessful attempts to read a record. This 
option is available only if selected at system 
generation. It should be used only when a tape is known 
to be faulty and there is no need to process every 
record. The error analysis (SYNAD) routine should keep a 
count of the number of permanent errors, and should 
terminate processing if the number becomes excessive. 

Only certain options can be selected with each access method, as 
follows : 




For 


BDAM: 




A or R E F W 




For BPAM: 




C W WC 




For BSAM and QSAM: 




B C T U W Z 


UC WC 


For EXCP: 




Z 




For QISAM: 




I L M R W Y 




For QSAM: 









For BSAM: 




H 




PRTSP= 
1 
2 
3 




Can b 

QSAM 



ZC 



Can be used with BSAM, EXCP, 
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Specifies the line spacing on a printer as 0, 1, 2, or 3 lines 
between printout. This subparameter is valid only if contror 
characters are not present (A or M is not specified in the RECFM 
subparameter) . 

If not supplied by any source, 1 is assumed. 

The subparameters PRTSP, CODE, KEYLEN, MODE, STACK, and TRTCH are 
mutually exclusive subparameters. Therefore, if PRTSP is coded, do 
not code any of these other subparaireters. 

RECFM=type Can be used with EDAM, BPAM, 

BSAM, EXCP, QISAM (output only), 
QSAM 

Specifies the format and characteristics of the records in the data 
set. The format and characteristics must be completely described 
by one source. 

If this subparameter is omitted, an undefined-length record is 
assumed with no optional features provided, except for QISAM where 
variable-length records are assumed, and QTAM where a message 
segment is assumed. 

Both the record format and characteristics are specified using the 
characters defined below. The allowable combinations of characters 
are indicated for the associated access methods; the characters 
must be coded in the order shown. 

Chara c ter Definitions 

A The record contains USASI control characters . 

B The records are blocked. 

F The records are of fixed length. 

G The message data provided in the work unit is a 
complete message. 

M The records contain machine code control 
characters. 

R The message data provided in the work unit is a 
complete record. 

S For fixed-length records, the records are 

written as standard blocks, i.e., no truncated 
blocks or unfilled tracks within the data set, 
with the exception of the last block or track. 

For variable-length records, a record may 
span more than one block. Exchange buffering 
(BFTEK=E) cannot be specified. 

For QTAM, the message data provided in the work 

unit is a message segment. 
T The records may be written onto overflow tracks 

if required. Exchange buffering (BFTEK=E) or 

chained scheduling (OPTCD=C) cannot be used. 
U The records are of undefined length. 
V The records are of variable length. 

Only certain characters and combinations of characters can be 
selected with each access method. The allowable combinations of 
characters are indicated for the associated access methods; the 
characters must be coded in the order shown. 

For EDAM: 
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For BPAM: 

r 

u 



"^ 



[T] 



< 



V 



r? 1 m 
LbtJ [mJ 

LbtJ 



> 



J 



For BSAM and QSAM: 

r 



U [Tl 



B 

S 

T 

BS 

BT 

ST 

BST 

B 

S 

T 

BS 

BT 

ST 

BST 




< 



> 



J 



Note: A or M cannot b€i specified if the PRTSP subparaweter is 
specified. 

For QISAM: 






For QTAM: 



REPOS= 



{^} 



Can be used only with EXCP, 



Specifies repositioning for tape devices. 

Y — Repositioning. A bit will be set to indicate that the user is 
keeping an accurate block count, and, if a permanent error 
occurs. Dynamic Device Reconfiguration (DDR) can use the block 
count to reposition. 

N — No repositioning. DDR will not attempt repositioning. 
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RKP=nuinber Can be used with QISAM (output 

only) 

Specifies the position of the first byte of the record key, 
relative to the beginning of each record. (The beginning byte of a 
record is addressed as 0.) 

If RKP=0 is specified for blocked fixed-length records, the key 
begins in the first byte of each record, and the delete option 
(OPTCD=L) must not be specified. If RKF=0 is specified for 
unblocked fixed-length records, the key is not written in the data 
field; the delete option can be specified. 

Foi: variable-length records, the relative key position must be 4 or 
greater, when the delete option (OPTCD=L) is not specified. The 
relative key position must be 5 or greater if the delete option is 
sp€icif ied. 

If this information is not specified by any source, a relative ke^^ 
position of zero is assumed. 

SOWA=number Can be used with Q1AM 

Specifies the size, in bytes, of the user-provided input work 
areas. The value must be less than 32,768 and must include the 
U-byte user prefix. 

If this subparameter is not specified by any source, the 
telecommunications job, when executed, is terminated. 

STACK=/1'I Can be used with ESAM, EXCP, QSAM 



{^ 



Specifies the stacker bin to receive the card, and is either 1 or 
2. 

If not specified by any source, 1 is assumed. 

The subparameter s STACK, CODE, KEYLEN, PRTSP, and TRTCH are 
mutually exclusive subparameters. Therefore, if STACK is coded, do 
not code any of these other subparameters. 

TRTCH=jC \ Can be used with ESAI^j, EXCP, gSAM 

)E / 
T j 

(etI 

Specifies the recording technique for seven-track tape. 

C — Data conversion feature is to be used, with odd parity 

and no translation. 
E — Even parity, with no translation and no conversion. 
T — Odd parity and no conversion, and BCD to iECDIC 

translation is required when reading; EBCDIC to BCD 

translation when writing. 
ET — Even parity and no conversion, and BCD to EBCDIC 

translation is required when reading; EBCDIC to BCD 

translation wnen writing. 

If this subparameter is not specified by any source, odd parity and 
no translation or data conversion is assumed. 
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The subparameters TRTCH, CODE, KEYLEN, MODE, PRSTP , and STACK are 
mutually exclusive subparameters. Therefore, if TRTCH is coded, do 
not code any of these other subparameters . 



Examples of the DCB Parameter 

1. //DDl DD DSNAME=ALP,DISP=(,KEEP) ,VOLUME=SER=44321, X 
// UNIT=2U00,DCB=(RECFM=FB,LRECL=240,BLKSIZE=9b0, X 
// DEN=1,TRTCH=C) 

This DD statement defines a new data set and contains the 
information necessary to complete the data control block. 

2. //DD2 DD DSNAME=BAL,d:[SP=OLD,DCB=(RECFM=F,LRECL=8 0, X 
// BLKSIZE=80) 

//DD3 DD DSNAME=CNANN,DISP=(,CATLG,DELETE),U]S1IT=2U00, X 

// LABEL=(,NL) ,V0LUME=SER=663U88 ,DCB=*. DD2 

The statement named DD3 defines a new data set and requests the 
system to copy the DCB subparameters from the DD statement named 
DD2, which is in the same job step. 

3. //DDU DD DSNAME=JST,DrSP=(NEW,KEEP),UNIT=2311, X 
// SPACE=(CYL, (12,2)) , DCB= (A,.B.C,KEYLEN=8) 

This DD statement defines a new data set and requests the system to 
copy DCB information from the data set label of the cataloged data 
set named A. B.C. If the data set label contains a key length 
specification, it is overridden since KEYLEN is coded on the DD 
statement . 

4. //DD5 DD DSNAME=SAME,DISP=OLD,UNIT=2311, X 
// DCB=(*.STEP1.PR0CSTP5.DD8,BUFN0=5) 

This DD statement defines an existing data set and requests the 
system to copy the DCB subparameters from the DD statement named 
DD8 , which is contained in the procedure step named PR0CSTP5. The 
cataloged procedure was called by the job step named STEPl . If any 
of the DCB subparameters coded on the procedure DD statement have 
been previously defined for this data set, they are ignored. If the 
BUFNO subparameter has not been previously specified for the data 
set, then five buffers are assigned to the data control block. 
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The DDNAME Parameter 

DDNAME=ddname 

ddname 

the name of a following DD statement in the same job step that 
defines this data set. 

Rules for Coding 

1. The only parameters that can be coded with the DDNAME parameter are 
the DCB subparameters BLKSIZE and BUFNC. For PCF, if the BLKSIZE 
or BUFNO subparameter is coded and the DDNAME parameter refers to a 
DD statement that defines data in the input stream (DD * or DD DATA 
statement) , the subparameter is ignored . 

2. The DDNAME parameter cannot appear on a DD statement named JOBLIB. 

3. You can code the DDNAME parameter up to five times in a job step or 
procedure step. However, each time the DDNAME parameter is coded, 
it must refer to a different ddname. 

4. If the data set, which will be defined later in the job step, is to 
be concatenated with other data sets, the DD statements that define 
these other data sets must immediately follow the DD statement that 
includes the DDNAME parameter. 

What the DDNAME Parameter Does 

The DDNAME parameter allows you to postpone defining a data set until 
later in the same job step. In the case of cataloged procedures, this 
parcumeter allows you to postpone defining a data set in the procedure 
until the procedure is called by a job step. 

The DDNAME parameter is most often used in cataloged procedures and 
in job steps that call procedures. It is used in cataloged procedures 
to postpone defining data in the input stream until a job step calls the 
procedure. (Procedures cannot contain DD statements that define data in 
the input stream, i.e., DD * or DD DATA statements). It is used in job 
steps that call procedures to postpone defining data in the input stream 
on an overriding DD statement until the last overriding DD statement for 
a procedure step. (Overriding DD statements must appear in the same 
order as the corresponding DD statements in the procedure, but in PCP a 
statement that defines data in the input stream must be the last 
overriding DD statement for a procedure step.) 

When You Code the DDNAME Parameter 

when the system encounters a DD statement that contains the DDNAME 
parameter, it saves the ddname of that statement. The system also 
temporarily saves the name specified in the DDNAME parameter so that it 
can relate that name to the ddname of a later DD statement. Once a DD 
statement with that corresponding name is encountered, the name is no 
longer saved. For example, if the system encounters this statement 

//XYZ DD DDNAME=PHOB 

the system saves XYZ and, temporarily, PHOB. Until the ddname PHOB is 
encountered in the input stream, the data set is a dummy data set. 
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when the system encounters a statement whose ddname has been 
temporarily saved, it does two things. It uses the information 
contained on this statement to define the data set; it associates this 
information with the name of the statement that contained the DDNAME 
parameter. The value that appeared in the DDNAME parameter is no longer 
saved by the system. To continue the above example, if the system 
encounters this statement 

//PHOB DD DSNAME=NIN,DISP= (NEW, KEEP) ,UNIT=2100 

the system uses the data set name and the disposition and unit 
information to define the data set; it also associates the ddname of the 
statement that contained the DDNAME parameter with this information. In 
this example, the ddname used is XYZ; the ddname PHOB is no longer 
saved. The data set is now defined, just as it would be if you had 
coded 

//XYZ DD DSNAME=NIN,DISP=(NEW,KEEP) ,UNIT=2U0O 

The system associates the ddname of the statement that contains the 
DDNAME parameter with the data set definition information. It does not 
use the ddname of the later statement that defines the data set. 
Therefore, any references to the data set, before or after the data set 
is defined, must refer to the DD statement that contains the DDNAME 
parameter, not the DD statement that defines the data set. The 
following seguence of control statements illustrates this : 

//DDl DD DDNAME=LATER 



//LATER DD DSN=SET12,DISP= CNEW, KEEP) ,UNIT=2311 ,VOLUME=SER=46231 , 
// SPACE=(TRK, (20,5)) 



//DD12 DD DSN=SET13,DISP=(NEW,KEEP) ,V0LUME=REF=*.DD1, X 

// SPACE=(TRK, (40,5)) 

When you want to concatenate data sets, the unnamed DD statements 
must follow the DD statement that contains the DDNAME parameter, not the 
DD statement that defines the data set. The following seguence of 
control statements illustrates this : 

//DDA DD DSNAME=DEFINE 

// DD DSN=A.B.C,DISP=OLD 

// DD DSN=SEVC,DISP=OLD,UNIT=2311,VOL=SER=52226 



//DEFINE DD * 

data 
/* 

You can use the DDNAME parameter up to five times in a job step or 
procedure step. However, each time the DDNAME parameter is coded, it 
must refer to a different ddname. 
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THE DCB SUBPARAMETERS BLKSIZE AND BUFNO 

Two DCB subparameters can be coded with the DDNAME parameter — BIKSIZE 
and BUFNO. This allows you to assign these DCB characteristics to the 
data set defined in the referenced DD statement. When the DCB 
subparameters BLKSIZE and BUFNO are coded both on the DD statement that 
contains the DDNAME parameter and on the referenced DD statement, the 
subparameters coded on the former are ignored. 



For MFT and MVT, these subparameters would most often be coded with 
the DDNAME parameter when the referenced DD statement defines data in 
the input stream. Data in the input stream for MFT and ^iVT is written 
onto a direct access device » and the records are blocked as they are 
written. The input reader procedure normally assigns a block size and 
number of buffers for blocking. Coding the BLKSIZE subparameter allows 
you to specify that you want shorter blocks . Coding the BUFNO 
subparameter allows you to specify that you want fewer buffers. You 
cannot specify that you want larger blocks or more buffers than would be 
assigned by the input reader procedure. (When a job is submitted via 
remote job entry and the BUFNO subparameter is coded, the EUFNO 
subparameter is ignored.) 




ns 



Examples of the DDNAME Parameter 



1. 



//STEPl 


EXEC 


PGM=PR0GRAM8 


//DDl 


DD 


DDNAME= INPUT 


//DD2 


DD 


DSNAME=WELL , DISP=OLD 



The above statements make up the statements for a procedure step 
named STEPl, which is the first step of a procedure named MENT. The 
following statements illustrate how you would define DDl as a data 
set in the input stream: 



//STPA EXEC 
//STEPl . INPUT 



PROC=MENT 
DD * 



/* 



data 



PGM=FIFTY 

DDNAME=DD 5 

UNIT=2400 

UNIT=2U00 

SYSOUT=B 

DSNAME=ADDN,DISP=(,PASS) ,UN1T=2U00 

PGM=FINE 

DSNAME=* . STU . DDl , DISP= (OLD , KEEP) 

The DD statement named DD5 defines the data set for the statement 
named DDl. The DD statement of the second job step wants the system 
to obtain the data set name, unit and volume information of this 
data set. This is done by referring to the DD statement that 
contains the DDNAME parameter. 



//STU 


EXEC 


//DDl 


DD 


//DD2 


DD 


//DD3 


DD 


//DD4 


DD 


//DD5 


DD 


//ST5 


EXEC 


//DD6 


DD 
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//STEPS 


EXEC 


//DDl 


DD 


// 


DD 


// 


DD 


//SKIP 


DD 



PGM=BLOCK 

DDNAME=SKIP 

DSNAME=A . B . C , DISP=OLD 

DSNAME=LEV . FIVE , DISP=OLD 

DSNAME=SEF,DISP=OLD,UNIT=2311,VOLUME=SER=llllll 



The DD statement named SKIP defines the data set for the statement 
named DDl. The two data sets, A. B.C. and LEV, FIVE, are 
concatenated with the data set named SEF. 



//STEPX 


EXEC 


PGM=PR0G12 


//DDl 


DD 


DDNAME=LATER,DCB=(BLKSIZE=1600,BUFNO=2) 


//DD2 


DD 


UNIT=2U00 


//DD3 


DD 


SYSOUT=F 


//LATER 


DD 


♦ 



data 



/* 



The DD statement named LATER defines the data set for the statement 
named DDl. If the job is run in MFT or MVT, the DCB subparameters 
coded with the DDNAME parameter are used to block the input data; in 
PCP, the DCB subparameters are ignored. 

PGM=BU03 

DSNAME=SEL,DISP=OLD,VOLUNjE=SER=X3220,UNIT=2400 

SYSOUT=B 



//STEPX 


EXEC 


//DDA 


DD 


//DUB 


DD 



The above statements make up the statements for a procedure step 
named STEPX, which is the first step of a procedure named TYPE. The 
following statements illustrate how you would use the DDNAME 
parameter when overriding both of the DD statements and the first 
overriding DD statement is to define data in the input stream: 



//CALL 


EXEC 


PROC=TYPE 


//STEPX. DDA 


DD 


DDNAME=IN 


//STEPX. DDB 


DD 


SYSOUT=G 


//STEPX . IN 


DD 


* 



/* 



data 



//MAR 
//CARDl 
//CARD 2 
//CARD 3 
//COGH 



EXEC PGiM=DEPT12 

DD DDNAME=CARD4 

DD UNIT=2400 

DD DSNAME=NINE.SCR,DISP=CLD 

EXEC PGM=DEPT13 



The DD statement named CARDl contains the DDNAME parameter. This 
statement defines a dummy data set since there is no DD statement 
named CARD4 in the step- 
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The DISP Parameter 



DISP=( 



NEW 
OLD 
SHR 
MOD 



, DELETE 
,KEEP 
,PASS 
,CATLG 
, UNCATLG 



, DELETE 
,KEEP 
,CATLG 
, UNCATLG 



NEW 



OLD 



SHR 



MOD 



specifies that the data set is to be created in this job step. 

specifies that the data set existed before this job step. 

specifies that the data set existed before this job step and can be 
used simultaneously (shared) by another job, since it will only be 
read. 




specifies that the read/write mechanisir is to be positioned after 
the last record in the data set, and, if the system cannot find 
volume information for the data set, specifies that the data set is 
to be created. 

, DELETE 

specifies that the data set is no longer needed and its space on 
the volume is to be released at the end of this job step for use by 
other data sets. 



,PASS 



,KEEP 

specifies that the data set is to be kept at the end of this job 
step on the volume. 

specifies that the data set is to be passed for use by a subsequent 
job step in the same job. 

, CATLG 

specifies that the data set is to be kept at the end of this job 
step and an entry pointing to the data set is to be placed in the 
system catalog. 

, UNCATLG 

specifies that the data set is to be kept at the end of this job 
step but the entry pointing to the data set in the system catalog 
is to be removed. 



specifies that a disposition is not explicitly specified for the 
data set, but a conditional disposition follows. A new data set is 
to be deleted and a data set that existed before execution of the 
job is to be kept at the end of this job step. 

, DELETE 

specifies that the data set is no longer needed and its space on 
the volume is to be released for use by other data sets if this 
step abnormally terminates. 



,KEEP 



specifies that the data set is to be kept on the volume if this 
step abnormally terminates. 
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, CATLG 

specifies that an entry pointing to the data set is to be placed in 
the systerr catalog if this step abnormally terminates. 

, UNCATLG 

specifies that the entry pointing to the data set in the system 
catalog is to be removed if this step abnormally terminates. 



Rules for Coding 

1. If only the first subparameter is coded, you need not enclose it in 
parentheses . 

2. If the data set is new, you can omit the subparameter NEW. 
However, if you specify a disposition or conditional disposition, 
you must code a comina to indicate the absence of NEW. 

3. You can omit the DISP parameter if a data set is created and 
deleted during a job step. 

4. If you do not want to change the automatic disposition processing 
performed by the systemi, you need not code the second subparameter. 
(When the second subparameter is not coded, the system 
automatically keeps data sets that did exist before the job and 
automatically deletes data sets that did not exist before the job.) 
If you omit the second subparameter and code a conditional 
disposition, you must code a comma to indicate the absence of the 
second subparamieter . 

5. The DISP, SYSOUT, and DDNAME parameters are mutually exclusive 
parameters; therefore, when SYSOUT or DDNAME is coded, do not code 
the DISP parameter. 

WHAT THE DISP PARAMETER DOES 

The DISP parameter describes to the system the status of a data set and 
indicates what is to be done with the data set after termination of the 
job step that processes it or at the end of the job. You can indicate 
in the DISP parameter one disposition to apply if the step terminates 
normally after execution and another to apply if the step terminates 
abnormally (conditional disposition) . 



Specifying the Data Set's Status 

A data set is either a new data set or an existing data set. What you 
plan to do with the data set determines which status you code as the 
first subparameter of the DISP parameter. Ther are four different 
subparameters that can be coded. These subparameter s allow you to tell 
the system: 

• The data set is to be created in the job step — NEW. 

• The data set existed before this job step — OLD. 

• The data set can be used by other concurrently executing jobs — 
SHR. 

• The data set is to be lengthened with additional output — MOD. 
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when you Specify NEW as the Data Set's St atus 

Specifying NEW as the first subparameter of the DISP parameter tells the 
system that the data set is to be created in the job step and may be 
used by the processing program to contain output data. If you omit the 
subparameter NEW, the system assumes the data set is to be created in 
the job step. (If you omit the subparameter NEW and specify a 
disposition or conditional disposition, you must code a comma to 
indicate the absence of NEW.) When the status of a data set is NEW, you 
must code on the DD statement all of the parameters necessary to define 
the data set. 

When You Specify OLD as the Data Set's Status 

Specifying OLD as the first subparameter of the DISP parameter tells the 
system that the data set existed before this job step. 

When You Specify SHR as the Data Set's Status 

Specifying SHR as the first subparameter of the DISP parameter tells the 
system that the data set resides on a direct access volume and other 
jobs that are executing concurrently with this job step may 
simultaneously use (share) the data set. when SHR is specified, any jcb 
step that uses the data set should only read the data set . 

The subparameter SHR need only be coded if you are operating under 
MET or MVT. If you code DISP= (SHR, DELETE) the system assumes OLD 
instead of SHR. If SHR is coded and you are operating under PCP, the 
system assumes the data set's status is OLD. Once you specify SHR for a 
data set, every reference to that data set within the jot must specify 
SHR or the data set can no longer be used by concurrently executing 
jobs. 

When You Specify MOD as the Dat a Set's Status 

Specifying MOD as the first subparameter of the DISP parameter tells the 
system that when the data set is opened for output, the read/write 
mechanism is to be positioned after the last record in the data set. 
MOD is specified when you want to add records to a data set with 
sequential, indexed sequential, or partitioned organization. MOD should 
not be specified for data sets with direct organization. When MOD is 
specified and the number of volumes required to lengthen the data set 
may exceed the number of units requested, specify a volume count in the 
VOLUME parameter. This ensures that the data set can be extended to new 
volumes . 

When MOD is specified, the system first assumes the data set exists. 
However, if the system cannot find volume information for the data set 
— on the DD statement, in the system catalog, or passed with the data 
set from a previous step — the system then assumes that the data set 
does not exist and the data set is created for the job step. Specifying 
MOD for a new sequential data set causes the read/write mechanism to be 
positioned after the last record in the data set each time it is opened 
for output. 

If MOD is specified and volume information exists, the first volumie 
of a multivolume data set will be mounted unless DEFER is specified in 
the UNIT parameter or (for tape data sets only) the VOLUME=REF parameter 
is used. 
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When you lengthen a data set that has standard labels, DCB 
information in the data control block must agree with the DCB 
information contained in the data set label. Conflicting DCB 
information, specifically conflicting block sizes, may make the data set 
unusable by later jobs. Therefore, do not code the DCB information 
contained in the data set label on the DD statement. If this DCB 
information is coded in the DCB macro instruction, be sure it agrees 
with the information contained in the data set label. 

If you extend a data set that has fixed block stanaard (FBS) records 
and the last block was a truncated one, an end-of-data set condition 
occurs when the truncated block is encountered. If an attempt is made 
to read the data set backward on magnetic tape, processing is terminated 
immediately (with an end-of-data set condition) upon reading the 
truncated block. 



Specifying a Disposition for the Data Set 

The second subparameter of the DISP parameter tells the system what is 
to be done with the data set at the end of the job step. If you want 
the data set to assume the same attributes it had before the job, you 
need not code the second subparameter of the DISP parameter. However, 
if a conditional dispostion is specified, you miust code a comma to 
indicate the absence of the second subparameter. When the second 
subparameter is not coded, data sets that existed before the job 
continue to exist and data sets that were created in the job step are 
deleted. If you create a nontemporary data set in the job and assign a 
disposition of PASS to it, the data set is deleted at termination of the 
job step that receives the passed data set and does not assign a 
disposition to it. (The passed nontemporary data set is deleted at job 
termination if the data set is never received by a later job step.) 

The system ignores the disposition you have coded and automatically 
keeps existing data sets and deletes new data sets when the step is 
abnormally terminated before the step begins execution, e.g., primary 
direct access space cannot be obtained. 

Sometimes the system does not perform disposition processing. The 
system does no disposition processing of data sets when: 

• The job step is bypassed because of an error that is found during 
interpretation of control statemients, e.g., a control statement 
containing errors is read. 

• The job step is bypassed because a return code test is satisfied. 

• The job step makes a nonspecific reguest for a tape volume and the 
data set is never opened. There is one exception to this: If the 
data set is defined as a new generation data set, the system 
performs the reguested disposition. 

• The job step reguests that the mounting of a direct access volume be 
deferred and the data set is never opened. 

Except for the cases mentioned above, the specified disposition is in 
effect for the data set if the job step terminates normally or 
abnormally and you have not specified a conditional disposition as the 
third subparameter of the DISP parameter. 
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There are five dispositions that can be specified for a data set. 
These dispositions allow you to: 

• Delete a data set — DELETE. 

• Keep a data set — KEEP. 

• Pass a data set to a later job step — PASS. 

• Catalog a data set — CATLG. 

• Uncatalog a data set — UNCATLG. 

When You Specify DELETE as the Dispositio n 

Specifying DELETE as the second subparaireter of the DISP parameter tells 
the system that you want the data set's space on the volume released at 
the end of the job step. If the data set resides on a tape voliame, the 
tape is rewound and the volume is available for use by other data sets 
at the end of the job step. If the data set resides on a direct access 
volume, the system removes the voliame table of contents entry associated 
with the data set and the data set's space is available for use by other 
data sets at the end of the job step. However, if the direct access 
data set's expiration date or retention period has not expired, the 
system does not delete the data set. You can use the lEHPROGM utility 
program to remove the volume table of contents entry. 

If you are deleting a cataloged data set, the entry for the data set 
in the system catalog is also removed, provided the system obtained 
volume information for the data set from the catalog, i.e., the volume's 
serial number was not coded on the DD statement. If the system did not 
obtain volume information from the catalog, the data set is still 
deleted but its entry in the catalog remains, in this case, you iray use 
the I£HPKOG^J utility programi to delete the entry. 

frihen You Specify KEEP as the Disposition 

Specifying KEEP as the second subparameter of the DISP parameter tells 
the system that you want the data set kept intact until a subsequent job 
step or job requests that the data set be deleted or until the 
expiration date is passed. (You can specify a retention period or 
expiration date in the LABEL parameter when the data set is created. If 
neither is coded in the LABEL parameter, a retention period of zero days 
is assumed by the system.) 

When You Specify PASS as the Disposition 

Specifying PASS as the second subparameter of the DISP parameter tells 
the system that the data set is to be passed after it is used in a job 
step. This permits another job step in the same job to use this data 
set without having retrieval and disposition processing done by the 
system. A passed data set may be referred to once in a later job step. 
You continue to code PASS each time the data set is referred to until 
the last time it is used in the job. At this time, you assign it a 
final disposition. If you do not assign the data set a final 
disposition, the system deletes the data set if it was created in the 
job and keeps the data set if it existed before the job. 

When the data set is not in use, the volume that contains the passed 
data set remains mounted; therefore, you need not code RETAIN in the 
VOLUME parameter of a DD statement that specifies a disposition of PASS. 
If the system must remove the volume that contains the passed data set, 
it ensures through messages to the operator that the volume is remounted 
before the data set is used again. 
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When a subsequent job step wants to use the passed data set, you irust 
include a DD statement for the step. On this DD stateirent, you must 
always code the ESNAME and DISP parameters. 

• The D3NAME parameter identifies the data set. Either code the data 
set's name or make a backward reference to any earlier DD statement 
in the job that defines the data set. 

• The DISP parameter specifies the data set's status and disposition. 
(If a later job step is to use this data set, specify a disposition 
of PASS; if this is the last job step that uses this data set, 
specify the data set's final disposition.) 

Tne other paramieters you miqht code are UNIT, LABEL, and DCB. 

« Code the UNIT parameter if you want more than one device allocated 
to the data set. 

• Code the LABEL parameter if the data set does not have standard 
labels . 

• Code the DCB parameter if the data set does not have standard labels 
and the first ED statement that defines the passed data set contains 
the DCB parameter. 

If several data sets used in the job have the same name, you can only 
pass one of these data sets at a time. A job step must refer to a 
passed data set and assign a disposition of other than PASS to the data 
set before another data set with the same name can be passed. 

When You Specify CATLG as th e Disposition 

Specifying CATLG as the second subparameter of the DISP parameter tells 
the system to create an index entry in the system catalog that points to 
this data set- The disposition CATLG also imiplies a disposition of 
KEEP. Once the data set is cataloged, you can retrieve the data set in 
later job steps and jobs by coding the DSNAME parameter and a status of 
other than NEW in the DISP parameter. 

You can specify a disposition of CATLG for an already cataloged data 
set. This should be done when you are lengthening the data set with 
additional output (a status of MOD is coded) and the data set may exceed 
one volume. If the system obtained volume informiation for the data set 
from the catalog and you code DISP= (MOD, CATLG) , the system updates the 
entry to include the volume serial numbers of any additional volumes. 

If the data set's name is enclosed in apostrophes, the data set must 
not be assigned a disposition of CATLG. If the data set you want 
cataloged has a qualified name, e.g., A. B.C., you must first create all 
but the lowest level of the name as indexes in the catalog. This is 
done using the lEHPROGM utility program. Once the indexes are 
establisned, you can request that a data set with a qualified name be 
cataloged. 

When You Specify UNCATLG as the Disposition 

Specifying UNCATLG as the second subparameter of the DISP parameter 
tells the system that you want the data set's entry in the system 
catalog removed at the end of the job step, UNCATLG does not tell the 
system to delete the data set. Later jobs that use this data set must 
provide on the DD statement all of the param.eters necessary to define 
the data set. 
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specifying a Conditional Disposition for the Data Set 

The third subparameter of the DISP parameter tells the system what is to 
be done with the data set if the step abnorirally terminates. If you do 
not specify a conditional disposition and the step abnormally 
terminates, the system uses the disposition specified as the second 
subparameter of the DISP parcuiieter to determine what is to be dene with 
the data set. (There are a few exceptions and they are noted under 
"Specifying a Disposition for the Data Set.") If a passed data set has 
not been received and a job step abnormally terminates, the passed data 
set assumes the conditional disposition specified the last time it was 
passed. In this case, conditional disposition processing is done at job 
termination, not at step termdnation. 

There are four conditional dispositions. When a job step abnormally 
terminates, these conditional dispositions allow you to: 

• Delete a data set — DELETE. 

• Keep a data set — KEEP,. 

• Catalog a data set — CATLG. 

• Uncatalog a data set — UNCATLG. 



When You Specify DELETE as the Conditional Disposition 

Specifying DELETE as the third subparameter of the DISP parameter tells 
the system that if the step Jibnormally terminates you want the data 
set's space on the volume released. DELETE is the only valid 
conditional disposition that can be specified for a data set assigned a 
temporary name or no name. If the data set resides on a tape volume, 
the tape is rewound and the volume toecomies available for use by other 
data sets at the end of the job step. If the data set resides on a 
direct access volume, the system removes the volume table of contents 
entry associated with the data set and th€i data set's space is available 
for use by other data sets at the end of the job step. However, if the 
direct access data set's expiration date or retention period has not 
expired, the system does not delete the data set. You can use the 
lEHPROGM utility program to remove the volumie table of contents entry. 

If the data set is cataloged, its entry in the system catalog is also 
removed, provided the systemi obtained volume information for the data 
set from the catalog, i.e., the volume's serial number was not coded on 
the DD statement. If the system did not obtain volume information from 
the catalog, the data set is still deleted but its entry in the catalog 
remains. In this case, you may use the lEBPROG^ utility program to 
delete the entry. 

When You Specify KEEP as the Conditional Disposition 

Specifying KEEP as the third subparameter of the DISP parameter tells 
the system that if the step abnormally terminates you want the data set 
kept intact until a subseguent job reguests that the data set be deleted 
or until the expiration date has passed. (You can specify a retention 
period or expiration date in the LABEL parameter when the data set is 
created. If neither is coded in the LABEL parameter, a retention period 
of zero days is assumed by the system.) 

Note : A scratch volume will be rewound, unloaded, and a KEEP message 
issued to the operator during abnormal termination of a jot step when: 
(1) a temporary data set written on the scratch volume has been assigned 
a nontemporary name, and (2) a conditional disposition of KEEP has been 
assigned to the data set. 
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when You Specify CATLG as the Conditional Disposition 

Specifying CATLG as the third subparameter of the DISP parameter tells 
the system that if the step abnormally terminates you want the system to 
create an entry in the system catalog that points to this data set. The 
conditional disposition of CATLG also implies a conditional disposition 
of KEEP. Once the data set is cataloged, you can retrieve the data set 
in later job steps and jobs by coding the DSNAf^E parameter and a status 
of other than NEW in the DISP parameter. 

If the data set's name is enclosed in apostrophes, the data set must 
not be assigned a conditional disposition of CATLG. If the data set has 
a qualified name, e.g., A. B.C., you must have created all but the lowest 
level of the name as indexes in the catalog before asking that the 
system catalog the data set. This is done using the lEHPKOGM utility 
program . 

When You Specify UN CATLG as the Conditional Disposition 

Specifying UNCATLG as the third subparameter of the DISP parameter tells 
the system that if the step abnormally terminates you want the data 
set's entry in the system catalog removed, UNCATLG does not tell the 
system to delete the data set. Later jobs that use this data set must 
provide on the DD statement all of the parameters necessary to define 
the data set. 



Disposition Processing Chart 

The system performs disposition processing of data sets at step 
termination. This processing is based on whether the step terminated 
normally or abnormally, the data set's status, the requested 
disposition, and the conditional disposition. Table 1 shows the 
disposition processing performed by the system based on these factors. 
(You may want to remove this page from the publication and place it in a 
convenient location, so that you and other programmers can refer to it.) 
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Tab-te 1. Disposition Processing Chart 



Status 


Requested Disposition 


Conditional Disposition 


Action Taken 
at Normal 
End of Stepl 


Action Taken at Abnormal End of Step , 
when Step Fails Due to : 


Action Taken at 
End of Job 


A^ 


b3 


C^ 


NEW or MOD^ 


none 


none 


deleted 


deleted 


deleted 


deleted 




KEEP 


none 


kept 


deleted 


kept 


deleted 




DELETE 


none 


deleted 


deleted 


deleted 


deleted 




CATLG 


none 


cataloged 


deleted 


cataloged 


deleted 




PASS 


none 


passed 


deleted 


passed 


passed 


deleted 


PASS 


any except 
UNCATLG^ 


passed 


deleted 


passed 


passed 


conditional 
disposition 


any except 
PASS 


KEEP 


requested 
disposition 


deleted 


kept 


kept 




any except 
PASS 


DELETE 


requested 
disposition 


deleted 


deleted 


deleted 




any except 
PASS 


CATLG 


requested 
disposition 


deleted 


cataloged 


cataloged 




OLD or MOD 
or SHR 


none 


none 


kept 


kept 


kept 


kept 




KEEP 


none 


kept 


kept 


kept 


kept 




DELETE 


none 


deleted 


kept 


deleted 


kept 




CATLG 


none 


cataloged 


kept 


cataloged 


kept 




UNCATLG 


none 


uncataloged 


kept 


uncataloged 


kept 




PASS 


none 


passed 


kept 


passed 


passed 


kept 


PASS 


any 


passed 


kept 


passed 


passed 


conditional 
disposition 


any except 
PASS 


KEEP 


requested 
disposition 


kept 


kept 


kept 




any except 
PASS 


DELETE 


requested 
disposition 


kept 


deleted 


deleted 




any exceot 
PASS 


CATLG 


requested 
disposition 


kept 


cataloged 


cataloged 




any except 
PASS 


UNCATLG 


requested 
disposition 


kept 


uncataloged 


uncataloged 




Footnotes : 

See list of exceptions in right-hand column. 
2 

In the following cases, the data set is not allocated to the job step and, therefore, no 

disposition processing is performed : a JCL error Is encountered; a return code test causes 
the job step to be bypassed; the job is cancelled before data set allocation; the system 
cannot allocate this data set to the job step. 
3 

This is the disposition processing that is performed when the job is cancelled after data 
set allocation or a processing program error occurs. 

4 

This is the disposition processing that is performed when this data set has been allocated 

to the step but the system cannot allocate some other data set to the job step. 

For MOD, a data set is considered to be a new data set if volume information is not 
available to the system. 

A conditional disposition other than DELETE is invalid for a data set that is assigned a 
temporary name or no name. The system assumes DELETE. 


List of Exceptions : 

1 . When a nontemporary data set is passed and the receiving step does not assign it a disposition, 
the system will, upon termination of this step, do one of two things. If the data set was new 
when it was initially passed, it will be deleted. If the data set was old when initially 
passed, it will be kept. Temporary data sets are deleted. 

2. If a job step makes a nonspecific request for a tape volume and the data set is never opened, 
no disposition processing is performed. 

3. If a job step requests that the mounting of a direct access volume be deferred and the data set 
is never opened, no disposition processing is performed, 

4. If automatic step restart is to occur, all data sets in the restart step with a status of OLD or 
MOD, and all data sets being passed to steps following the restart step, are kept. All data 
sets in the restart step with a status of NEW are deleted. 

5. If automatic checkpoint restart is to occur, all data sets currently in use by the job are kept. 

6. When dedicated data sets are used in a job step, any disposition assigned to them is internally 
changed to PASS or KEEP to prevent deletion of the dedicated data sets. 



I 



Examples of the DISP Parameter 

1. //DD DD DSNAME=D99.Gi?OUP.SIX,U!SIIT=2311,VOLUJyiE=SLR^llllll, X 
// DISP= (NEW , CATLG , DELETE) , SPACE= (TRK ,(5,1)) 

This DD statement defines a new data set and requests the system to 
create an index entry in the system catalog that points to this data 
set if the step terminates normally. It also requests the system to 
delete the data set, instead of cataloging it, if the step 
abnormally terminates. Because the data set's name is qualified, 
the lEHPROGM utility program must be used to create the indexes in 
the catalog for D99 and GROUP before you request the system to 
catalog the data set. 



//DD2 DD DSNANE=FIX,UNIT=2U00-l,VOLUME=SER=Uit889, } 

// DISP= (OLD, , DELETE) 

This DD statement defines an existing data set ana implies that the 
data set is to be kept if the step termdnates normally. (For an 
existing data set, the system assumes it is to keep the data set if 
no disposition is specified.) The stcitement requests the system to 
delete the data set if the step abnormally terminates. 




//STEPl 


EXEC 


//DDl 


DD 


// 




//STEP 2 


EXEC 


//DD2 


DD 


//DD3 


DD 


//STEP 3 


EXEC 


//ED4 


DD 



PGM=FILL 

DSNAFjE=SWITCH.LEVEL18.GRCUP12,UN1T=2311, X 

V0LUME=SER=L0CAT3,SPACE=(TRK, (80,1b)) ,DISP= ( , PASS) 

PGM=CHAR 

DSNAME=XTRA , DISP=OLD 

DSNA^iE=* .. STEPl . DDl , DI3P= (CLE , PASS , DELETE) 

PGM=TERM 

DSNAME=*.,STEP2.DD3,DISP= (OLD, DELETE) 



The DD statem.ent named DDl in STEPl define 
requests that the data set be passed. If 
terminates, the data set is deleted since 
conditional disposition was not specified. 
DD3 in STEP2 receives the passed data set 
set be passed. If STEP2 abnormally termin 
deleted because of the conditional disposi 
statement named DD4 in STEP3 receives the 
requests that the data set be cataloged at 
STEP3 abnormally terminates, the data set 
conditional disposition of DELETE. 



s a new data set and 

STEPl abnormially 

it is a new data set and a 

The DD statement named 
and requests that the data 
ates, the data set is 
tion of DELETE. The DD 
passed data set and 

the end of the step. If 
is deleted because of the 
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The DSNAME Parameter 



iDSNA]y!El.= 
IDSN f 



n 



-\ 



< 



y 



dsnaine 

ctsnaine (member naire) 

dsnaine (generation number) 

dsnaiT;e(area name) 

gSdsname 

€&dsname (member name) 

&&dsname(area name) 

*.ddname 

* . stepname . ddname 

*.stepname.procstepname .ddname . 

dsname 

identifies a data set name. 

dsname (member name) 

identifies a nontemporary partitioned data set name and the name of 
a member v?ithin that data set. 




dsname (generation number) 

identifies a generation data group by its namie and a generation 
data set by its generation number (a zero or signed integer.) 

dsnam.e(area name) 

identifies a nontemporary indexed sequential data set name and an 
area of that data set (INDEX, PRIME, or CVFLOW.) 

&&dsname 

specifies the name you want assigned to a temporary data set. 

&&dsname (member name) 

specifies the name you want assigned to a temporary partitioned 
data set and to a member within that data set. 

&&dsname(area name) 

specifies the name you want assigned to a temiporary indexed 
sequential data set and identifies an area of that data set (INDEX, 
PRIMJi, or OVFLOW.) 

*. ddname 

specifies that the data set name is to be copied from the nam.ed DD 
statement, which is an earlier DD statemient in the job step. 

* . stepname . ddname 

specifies that the data set name is to be copied fromi an earlier DD 
statement named ddnamie, which appears in an earlier step named 
stepname in the same job. 

* . stepname . procstepname . ddname 

specifies that the data set namie is to be copied from an earlier DD 
statement in a cataloged procedure. Stepname is the name of the 
job step that calls the procedure, procstepname is the name of the 
procedure step that includes the named DD statement, and ddname is 
the name of the DD statemient that contains the data set name. 



Rules for Coding 



1. An unqualified data set name m^ay consist of 1 of 8 characters, 
first character must be an alphabetic or national (a,*,#) 
character; the remiaining characters ccin be any alphameric or 
national characters, a hyphen, or a plus zero (12-0 punch). A 



The 
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temporary data set name can consist of 1 through 8 characters, 
excluding the ampersands; the first character following an 
ampersand must be an alphabetic or national character. 

2, /^ qualified name may consist of up to 44 characters including 

periods. For each eight characters or less there must be a period, 
and the character following a period must be an alphabetic or 
national (f9,$,#) character. 

3.. You need not code the DSNAI^E parameter if the data set is created 
and deleted in the job, i.e., if the data set is temporary. 

4. The DSNAME and DDNA^Jt parameters are mutually exclusive parameters; 
therefore, when the DDNAME parameter is coded, do not code the 
DSNAME parameter. 

IDENTIFYIINIG THE DATA SET 

When you create a data set, you use the DSNAKL parameter to assign a 
name to the data set. The data set name is part of the information 
stored with the data set on a volume. Later, when another job step or 
job wants to use the data set, it identifies the data set name in the 
DSNAMJi parameter; the system uses the data set name to locate the data 
set on the volume. 

How you code the DSNAME paramieter depends on the type of data set and 
whether the data set is nontemporary or temporary. 

Creating or Retrieving a Nontemporary Data Set 

If the data set is nontemporary, you can identify: 

• A permanent data set by coding DSNAME=dsnamie. 

• A member of a nontemporary partitioned data set by coding 
DSNAiyiE=dsname (member nam^e) . 

• A gcmeration of a nontemporary generation data group by coding 
D S NAME =dsname (number) . 

• An cirea of a nontemporary indexed sequential data set by coding 
DSNAMF=dsname (area nam.e) . 

Nontemporary Data Sets 

When a nontemporary data set is created, it is assigned a name in the 
DSNAME parameter and is assigned a disposition of KEEP or CATLG. (A 
data set assigned a disposition of KEEP may be assigned a disposition of 
CATLG by a later job step or job.) The name you assign to a 
nontemporary data set must be specified in the DSNAME parameter by all 
other steps and jobs that want to use the data set. 

A nontemporary data set name can be either a unqualified or qualified 
name. An unqualified data set name consists of 1 through 8 characters. 
The first character must be an alphabetic or national (a,#,$) character; 
the remaining characters can be any alphameric or national characters, a 
hyphen, or a plus zero (12-0 punch) . 

A qualified data set name consists of 1 through 44 characters 
(including periods) , except when the qualified name identifies a 
generation data group. In this case, the data set name may consist of 
only 1 through 35 characters (including periods). For each eight 
characters or less there must be a period, and the first character of 
the name and the character following a period must be an alphabetic or 
national (a,#,$) character. 
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If you assign a qualified name to a data set that is to be cataloged, 
all but the lowest level of the name must already exist as indexes in 
the system catalog before you can request the system to catalog the data 
set. An index level is created by using the lEHPROGK utility program. 
Once the indexes are established, the data set can be cataloged. 

When you request a data set that is cataloged on a control volume 
other than the system catalog, the system attempts to mount this control 
volume if it is not already mounted. After the system obtains the 
pointer to this data set, the control volume may then be demounted by 
the system if the unit on which it was mounted is required by another 
volume. If you plan to delete, uncatalog, or recatalog the data set, 
the volume must be mounted during disposition processing Cat the end of 
the job step) in order for the pointer to be deleted or revised. You 
can ensure that the volume remains mounted by requesting the operator to 
issue a MOUNT command for this volume before the job step is initiated. 
If you do not use the MOUNT command to mount the volume and if the 
volume is not mounted during disposition processing, then, after the job 
has terminated, use the lEHPROGM utility program to delete or revise the 
pointer in the control volumes. (In order for the system to mount a 
control volume, the control volume must be logically connected to the 
system catalog. This is done using the CONNECT function of the lEHFEOGM 
utility program, which is described in the Utilities publication.) 

Members of a Partitioned Data Set 

A partitioned data set consists of independent groups of sequential 
records, each identified by a member name in a directory. When you want 
to add a member to a partitioned data set or retrieve a member, you 
specify the partitioned data set name and follow it with the member 
name. The member name is enclosed in parentheses and consists of 1 to 8 
characters. The first character must be an alphabetic or national 
(a,$,#) character; the remaining characters can be any alphameric or 
national characters . 

Generations of a Generation Data Group 

A generation data group is a collection of chronologically related data 
sets that can be referred to by the same data set name. When you want 
to add a generation to a generation data group or retrieve a generation, 
you specify the generation data group name and follow it with the 
generation number. The generation number is enclosed in parentheses and 
the niamber is a zero or a signed integer. A zero represents the most 
current generation of the group; a negative integer (e.g., -1) 
represents an older generation; a positive integer (e.g., +1) represents 
a new generation that has not as yet been cataloged. 

To retrieve all generations of a generation data group (up to 255 
generations), code only the group name in the DSNAME parameter and the 
DISP parameter. 

A complete discussion of creating and retrieving generation data sets 
is contained in "Appendix D: Creating and Retrieving Generation Data 
Sets" in this publication. 

Areas of an Indexed Sequential Data Set 

The areas used for an indexed sequential data set are the index, prime, 
and overflow areas. When you are creating the data set and define any 
of these areas on a DD statement, you must identify the data set name 
and follow it with the area name you are defining. The area name is 
enclosed in parentheses and is either PRIME, INDEX, or OVFLOW. If you 
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are using only one DD statement to define the entire data set, code 
DSNAME=dsname or DSNAME=dsnaine (PRIME) . When you retrieve the data set, 
you code only the data set name; you do not include the term PRIME, 
INDEX, or OVFLOW. For detailed information on how to create and 
retrieve indexed sequential data sets, refer to "Appendix C: Creating 
and Retrieving Indexed Sequential Data Sets" in this publication. 



Creating or Retrieving a Temporary Data Set 

If the data set is temporary, you can identify: 

• A temporary data set by coding DSNAME=S&dsname. 

• A member of a temporary partitioned data set by coding 
DSNAME=&Sdsname (member name). 

• An area of a temporary indexed sequential data set by coding 
DSNAME=&&dsname(area name). 



Temporary Data Set s 

Any data set that is created and deleted within the same job is a 
temporary data set. A DD statement that defines a temporary data set 
need not include the DSNAME parameter; the system generates one for you. 

If you do include the DSNAME parameter, the temporary data set name 
can consist of 1 through 8 characters and is preceded by two ampersands 
(6&). The character following the ampersands must be an alphabetic or 
national (a,#,$) character; the remaining characters can be any 
alphameric or national characters. (A temporary data set name that is 
preceded by only one ampersand is treated as a temiporary data set name 
as long as no value is assigned to it either on the EXEC statement for 
this job step when it calls a procedure, or on a PROC statement within 
the procedure. If a value is assigned to it by one of these means, it 
is treated as a symbolic parameter. Symbolic parameters are discussed 
in Appendix A.) 

The S3/stem generates a qualified name for the temporary data set, 
which begins with SYS and includes the jobnam.e, the temporary neime 
assigned in the DSNAME parameter, and other identifying characters. 

If you attempt to keep or catalog a temporary data set (you specify a 
disposition of KEEP or CATLG in the DISP parameter) , the system changes 
the disposition to PASS and the data set is deleted at job termination. 
However , this change is not made for a data set on a tape volume when 
the following conditions exist: (1) the data set is new; (2) the data 
set is not assigned a name; and (3) DEFER is specified in the UNIT 
parameter. The data set is deleted at job termination, but the system 
tells the operator to keep the volume on which the data set resided 
during the job. 

Members of a Temporary Partitioned Data Set 

When you want to add a member to a temporary partitioned data set or 
retrieve a member during the job, you specify the partitioned data set's 
temporary name and follow it with the member name. The member name is 
enclosed in parentheses and consists of 1 to 8 characters . The first 
character must be an alphabetic or national (a,$,#) character; the 
remaining characters can be any alphameric or national characters. 
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Areas of a Temporary Indexed Sequen-tial Data Set 

The areas used for an indexed sequential data set are the index, prime, 
and overflow areas. When you are creating a teirporary indexed 
sequential data set and define any of these areas on a DD statement, you 
must identify the data sets's temporary name and follow it with the area 
name you are defining. The area name is enclosed in parentheses and is 
either PRIME, INDEX, or OVFLOW. If you are using only one DD statement 
to define the entire temporary data set, code DSNAJyiE=&Sdsnam.e or 
DSNA]yiE=g&dsname (PRIME) , If you want to retrieve the temporary data set 
in the same job, you code only the data set's temporary namie; you do not 
include the term PRIME, INDEX, or OVFLOW. For information on how to 
create and retrieve indexed sequential data sets, refer to "Appendix C: 
Creating and Retrieving Indexed Sequential Data Sets" in this 
publication. 

Using a Dedicated Data Set 

If your installation provides dedicated data sets in a system with MVT, 
you can use these data sets to contain your data instead of creating 
your own temporary data sets. The use of dedicated data sets eliminates 
some of the time required to schedule a job step since the data sets are 
already allocated. 

To use a dedicated data set, code DSNAME=g6name or DSNAME=&name on a 
DD statement, along with all other parameters required to define your 
temporary data set, e.g., UNIT, SPACE, DCB. Replace the term "name" 
with the ddname of the DD statement in the initiator cataloged procedure 
that defines the dedicated data set you want to use. If the system 
cannot assign you this dedicated data set, the parameters coded on your 
DD statement are used to create a temporary data set. (For detailed 
information on dedicated data sets, refer to the chapter "System Reader, 
Initiator and Writer Cataloged Procedures" in the publication System 
Programmer * s Guide . ) 



Copying the Data Set Name From an Earlier DD Statements 

The name of a data set that is used several times in a job, whether 
specified in the DSNAME parameter or assigned by the system., can be 
copied after its first use in the job. This allows you to easily change 
data sets from job to job and eliminates your having to assign names to 
temporary data sets. To copy a data set name, refer to an earlier DD 
statement that identifies the data set. When the earlier DD statement 
is contained in an earlier job step, you code DSNAME=*.stepnaiiie. ddname; 
when the earlier DD statement is contained in the sam.e job step, you 
code DSNAME=* . ddname ; when the earlier DD statement is contained in a 
cataloged procedure step called by an earlier job step, you code 
DSNAME=* . stepname . procstepname . ddname . 



Specifying the DSNAME Parameter in Apostrophes 

Sometimes, it may be necessary or desirable to specify a data set name 
that contains special characters. If the name contains special 
characters, you must enclose the name in apostrophes (5-8 punch), e.g., 
DSNAME=*DAT+5' . If one of the special characters is an apostrophe, you 
must identify it by coding two consecutive apostrophes (two 5-8 punches) 
in its place, e.g., DSNAME= •DAY' 'SEND' . A data set name enclosed in 
apostrophes can consist of 1 through 44 characters. 
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There are cases when your data set naire must contain required special 
characters, which tell the system something about the data set (e.g., &(, 
in DSNAME=6&name are required special characters that tell the system 
that this is a temporary data set). In these cases, the data set name 
must not be enclosed in apostrophes because the system will not 
recognize the required special characters aS having any special 
significance. The following data set names contain special characters 
that tell the system something about the data set and, therefore, cannot 
be enclosed in apostrophes : 

• DSNAME=name (member name) 

• DSNAiyiE=name(area name) 

• DSNAiyiE=name (generation number) 

• DSNAME=&Sname 

• DSNAME=*.stepname.ddname 

Keep the following rules in mind: 

1. If the data set is to be cataloged, the data set name cannot be 
enclosed in apostrophes. 

2. If the data set name begins with a blank character, the data set is 
assigned a temporary data set name by the system. 

3. If the data set name ends with a blank character, the blank is 
ignored. 

U. If the only special character is a period or a hyphen, you need not 
enclose the data set name in apostrophes. 



Examples of the DSNAME Parameter 

1. //DDl DE DSNAiyiE=ALPHA,DISP=(,KEEP) , X 
// I3NIT=2400,VOLUiyiE=SER=389984 

This DD statement defines a new data set whose name is ALPHA. Later 
job steps or jobs may retrieve this data set by supplying the data 
set name in the DSNAME parameter, unit information in the UNIT 
parameter, and volume information in the VOLUME parameter. 

2. //DD2 DD DSNAME=PDS(PR0G12) ,DISP= (OLD, KEEP) ,UNIT=2311, X 
// VOLUME=SER=882234 

This DD statement retrieves a member of a partitioned data set named 
PDS. 

3. //DD3 DD DSNAME=6SWORK,UNIT=2400 

This DD statem.ent defines a temporary data set. Since the data set 
is deleted at the end of the job step, the DSNAME parameter could be 
omitted. 

PGM=CREATE 

DSNAME=&&ISDATA( PRIME) ,DISP= ( ,PASS) , UNIT= ( 2311, 2) , X 

SPACE=(CYL, (10, , 2) , ,CONTIG) ,VOLUME=SER= (33U89 , 33490) 

PGM=OPER 

DSNAME=* . STEPl . DD4 , DISP= (OLD , DELETE ) 

The DD statement named DDU in STEPl defines a temporary indexed 
sequential data set whose name is ISDATA. This DD statement is used 
to define all of the areas of an indexed sequential data set. The 
DD statement named DD5 in STEP2 retrieves the data set by referring 
to the earlier DD statement that defines the data set. Since the 
temporary data set is passed when it is defined in STEPl, STEP2 can 
retrieve the data set. 

170 JCL Reference 



//STEPl 


EXEC 


//DDU 


DD 


// 




//STEP 2 


EXEC 


//DD5 


DD 



The LABEL Parameter 



LABEL=([data set sequence number] 



,SL 

,SUL 

,NSL 

,NL 

,BLP 



r, password] Tin ~| ;'[ ^ j^rEXPDT^yydddl ) 
Uv, LoUTn--'' RETPD=nnnn 



data set sequence number 

specifies the relative position of a data set on a tape volume. 

specifies that the data set has standard labels. 

,SUL 

specifies that the data set has both standard and user labels. 

,NSL 

specifies that the tape data set has nonstandard labels. 

,NL 

specifies that the tape data set has no labels. 

,BLP 

specifies that the system is not to perform label processing for 
the tape data set. 

f 

specifies that the data set has standard labels and another 
subparameter follows . 

, PASSWORD 

specifies that the new data set is accessible by later jobs only 
through use of a password, i.e., the data set is to be password 
protected . 

specifies that another subparameter follows and, for a new data 
set, the data set is not to be password protected. 

,IN 

specifies that the data set is to be processed for input only. 

,OUT 

specifies that the data set is to be processed for output only. 

(') 

specifies that either the RETPD or EXPDT subparameter follows and 

one or more subparameters precede it. 

EXPDT=yyddd 

specifies the date when the data set can be deleted or overwritten 
by another data set. Assign a 2-digit year num.ber and a 3-digit 
day number. 

RETPD=nnnn 

specifies the length of time in days that the data set must be 
kept. Assign the number of days that must pass before the data set 
can be deleted or overwritten by another data set. 
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Rules for Coding 

1, All the subparairieters except the last subparameter in the LABEL 

parameter are positional subparameters. Therefore, if you want to 
omit a subparameter, you must indicate its absence with a comma. 

2.. If the only subparameter you want to specify is the data set 

sequence number, RETPD or EXPDT, you can omit the parentheses and 
commas and code LABEL=data set sequence number, LABEL=RETPD=nnnn, 
or LAEEL=EXPDT=yyddd. 

3. If the data set has standard labels, you can omit the subparameter 

SL. 

U. When you are defining a data set that resides or will reside on a 
direct access volume, only SUL or SL can be specified as the second 
subparameter , 

"D, The LABEL, DDNAME, and SYSOUT parameters are mutually exclusive 
parameters; therefore, if DDNAME or SYSOUT is coded, do not code 
the LABEL parameter. 



DATA SET LABELS 

Labels are used by the operating system to identify volumes and the data 
data sets they contain, and to store data set attributes. Data sets 
residing on magnetic tape volumes usually have data set labels. If data 
set labels are present, they precede each data set on the volume. Data 
sets residing on direct access volumes always have data set labels. 
These data set labels are contained in the volume table of contents at 
the beginning of the direct access volume. 

A data set label may be a standard or nonstandard label. Standard 
labels can be processed by the system; nonstandard labels must be 
processed by nonstandard label processing routines, which the 
installation includes in the system. Data sets on direct access volumes 
must have standard labels. Data sets on tape volumes usually have 
standard labels, but can have nonstandard labels or no labels. 

Tape label definitions and associated tape label processing are 
included in the Tape Labels publication. Direct access label 
definitions and associated direct access label processing are described 
in "Appendix A: Direct Access Labels" in the Supervisor and Data 
Management Services publication. 



When to Code the LABEL Parameter 

The LABEL parameter must be coded if: 

• You are processing a tape data set that is not the first data set on 
the reel; in this case, you must indicate the data set sequence 
number. 

• The data set labels are not standard labels; you must indicate the 
label type. 

• You want to specify what type of labels a data set is to have when 
it is written on a scratch volume; you must indicate the label type. 
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• The data set is to be password protected; you must specify PASSVviORD 
when you create the data set. 

• The data set is to be processed only for input or output and this 
conflicts with the processing method indicated in the CPEN macro 
instruction; you must specify IN, for int:ut, or OUT, for outputu 

• The data set is to be kept for some period of time; you must 
indicate a retention period (RETPD) or expiration date (EXPDT) . 

THE DATA SET SEQUENCE NUMBER SUBPARAMETER 

When you want to place a data set on a tape volume that already contains 
one or more data sets, you must specify where the data set is to be 
placed, i.e., the data set is to be the second, third, fourth, etc., 
data set on the volum.e. The data set sequence number causes the tape to 
be positioned properly so that the data set can be written on the tape 
or retrieved. 

The data set sequence number subparameter is a positional 
subparameter and is the first subparameter that can be coded. The data 
set sequence number is a 1- to 4-digit number. The system assumes 1, 
i.e., this is the first data set on the reel, if you omit this 
subparameter or if you code 0. 

When you request the system to bypass label processing (BLP is coded 
as the label type in the LABEL parameter) and the tape volume contains 
labels, the system treats anything between tapemarks as a data set. 
Therefore, in order for the tape with labels to he positioned properly, 
the data set sequence number must reflect all labels and data sets that 
precede the desired set. Section I of the Tape Label s publication 
illustrates where tapemarks appear. 



THE LABEL TYPE SUBPARAMETER 

The label type subparameter tells the systemi what type of labels is 
associated with the data set. The label type subparameter is a 
positional subparameter and must be coded second, after the data set 
sequence number subparameter. You can omit this subparameter if the 
data set has standard labels. 

The label type subparameter is specified as: 

• SL — if the data set has standard labels. 

• SUL — if the data set has both standard and user labels. 

• NSL — if the data set has nonstandard labels. 

• NL — if the data set has no labels. 

• BLP — if you want label processing bypassed. 

SL or SUL is the only label type that can be specified for data sets 
that reside on direct access volumes. 

When SL or SUL is specified, or the label type subparameter is 
omitted and the data set has standard labels, the system can ensure that 
the correct tape or direct access volume is mounted. When you specify 
NSL, installation-provided nonstandard label processing routines must 
ensure that the correct tape volume is mounted. When you specify NL or 
BLP, the operator must ensure that the correct tape volume is mounted. 
If you specify NL, the data set miust have no standard labels. 

For cataloged and passed data sets, label type information is not 
kept. Therefore, any time you refer to a cataloged or passed data set 
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that has other than standard labels, you must code the Li^BEL parameter 
and specify the label type. 

BLP is not a label type, but a request to the systeir to bypass label 
processing. This specification allows you to use a blank tape or 
overwrite a seven-track tape that differs from your current parity or 
density specifications. Bypass label processing is an option of the 
operating system. In PCP, the option is selected during systeir 
generation; in MFT and MVT the option is specified as a PARM field value 
in the reader cataloged procedure. If the option is not selected and 
you have coded BLP, the system assuires NL. 

Note for BLP ; When you request the system to bypass label processing 
and the tape volume has labels, the system treats anything between 
tapemarks as a data set. Therefore, in order for a tape with labels to 
be positioned properly, the data set sequence nuircer subparameter of the 
LABEL parameter must be coded and the subparameter must reflect all 
labels and data sets that precede the desired data set. Section I of 
^^^ Tape Labels publication illustrates where tapemarks appear. 

The label type subparameter can also be specified when you make a 
nonspecific volume request for a tape volume (i.e., no volume serial 
numbers are specified on the DD statement) and you want the data set to 
have a certain type of labels. If the volume that is mounted does not 
have the corresponding label type you desire, you miay be able to change 
the label type. 

When you specify NL or NSL and the operator miounts a tape volume that 
contains standard labels, you may use the volume provided: (1) the 
expiration date of the existing data set on the volume has passed; (2) 
the existing data set on the volume is not password protected; and (3) 
you make a nonspecific volume request. All of these conditions miust be 
met. If they are not, the system requests the operator to mount another 
tape volume. 

When you specify SL and the operator mounts a tape volume that 
contains other than standard labels, the system requests the operator to 
identify the volume serial number and its new owner before the standard 
labels are written. 



THE PASSWORD SUBPARAMETER 

The PASSWORD subparameter tells the system that you want the data set 
password protected. A data set that is password protected cannot be 
used by any other job step or job unless the operator can supply the 
system with the correct password for the data set. 

The PASSWORD subparameter is a positional subparameter and must be 
coded third, after the data set sequence number subparamieter and the 
label type subparameter or the comimas that indicate their absence. If 
you want the data set password protected, specify PASSWORD when the data 
set is created. Password protected data sets must have standard labels. 

THE IN AND OUT SUBPARAMETERS 

Tne basic sequential access method (BSAM) permits a specification of 
INOUT or OUTIN in the OPEN macro instruction as the processing method. 
If you have specified either of these processing methods in the OPEN 
macro instruction and want to override it, you may be able to do so by 
coding either the IN or OUT subparameter. For FORTRAN users, the IN and 
CUT subparameters provide a means of specifying how the data set is to 
be processed, i.e., for input or output. 
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when INOUT is specified in the OPEN macro instruction and you want 
the data set processed for input only, you can specify the IN 
subparameter. When the IN subparameter is coded, any atteirpt by the 
processing prograir to process the data set for output is treated as an 
error. 

When OUTIN is specified in the OPEN macro instruction and you want 
the data set processed for output only, you can specify the OUT 
subparameter. When the OUT subparameter is coded, any attempt by the 
processing program to process the data set for input is treated as an 
error. 

The IN and OUT subparameters are positional subparameter s. If either 
is coded, it must appear as the fourth subparameter, after the data set 
seguence number subparameter, the label type subparameter, and the 
PASSWORD subparameter, or the commas that indicate their absence. 

THE RETPD AND EXPDT SUBPARAMETERS 

When it is necessary that a data set be kept for some period of time, 
you can tell the system how long it is to be kept when you create the 
data set. As long as the time period has not expired, a data set that 
resides on a direct access volume cannot be deleted by or overwritten by 
another job step or job. (If it is necessary to delete such a data set, 
you can use the lEHPROGM utility program, to delete the data set. The 
lEHPROGM utility program is described in the Utilities publication.) 

There are two different ways to specify a time period: (1) tell the 
system how many days you want the data set kept, the RETPD subparameter, 
or (2) tell the system the exact date after which the data set need no 
longer be kept, the EXPDT subparameter. 

If you code the RETPD subparameter, you specify a 1- to U-digit 
number, which represents the number of days the data set is to be kept. 
If you code the EXPDT subparameter, you specify a ^-digit year number 
and a 3-digit day niimber (e.g., January 1 would be 001, July 1 would be 
182) , which represents the date after which the data set need no longer 
be kept. When neither the RETPD or EXPDT subparameter is specified for 
a new data set, the system assumes a retention period of zero days. 

The RETPD or EXPDT subparameter roust follow all other subparameters 
of the LABEL parameter. If no other subparameters are coded, you can 
code LABEL=RETPD=nnnn or LABEL=EXPDT=yyddd. 

Examples of the LABEL Parameter 

1. //DDl DD DSNAME=HERBI,DISP= (NEW, KEEP ),UNIT=TAPE, X 
// V0LUME=SER=T2 , LABEL= ( 3 , NSL , RETFD=1 8 8 ) 

This DD Statement defines a new data set. The LABEL parameter tells 
the system: (1) this data set is to be the third data set on the 
tape volume; (2) this d<ita set has nonstandard labels; and (3) this 
data set is to be kept for 188 days. 

2. //DD2 DD DSNAME=A. B.C,DISP=(,CATLG, DELETE) ,UNIT=2400-2, X 
// LABEL=(,NL) 

This DD Statement defines a new data set and requests the system to 
catalog it. The catalog entry for this data set will not indicate 
that the data set has no labels. Therefore, each time this data set 
is referred to by a DD statement, the statement must include 
LABEL=(,NL) . 
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3. //DD3 DD DSNAME=SPECS, UNIT= 240 0,VOLmviE=SER=l 0222, X 

// DISP=0LD,LAB£,L=4 

This DD statement defines an existing data set. The Li?^BEL parameter 
indicates that the data set is the fourth data set on the tape 
volume. 

PGM=FIV 

DSNAME=CLEAR,DISP= (OLD, PASS), UNIT=2400-4, X 

V0LUME=3ER=1 2 57 , LABEL= ( , NSL) 

PGM=BOS 

DSNAME=* . STEPl . DDX , DISP=CLD , LABEL= ( , NSL) 

The DD statement named DDX in STEPl defines an existing data set 
that has nonstandard labels and requests the system to pass the data 
set. The DD statement named DDY in STEP2 receives the passed data 
set. Unit and volume information is not specified since this 
information is available to the system; the label type is not 
abailable to the system and must be coded. 



//STEPl 


EXEC 


//DDX 


DD 


// 




//STEP2 


EXEC 


//DDY 


DD 
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The OUTLIM Parameter-MFT, MVT 

OUTLI]yi=number 

number 

the limit for the number of logical records you want included 
in the output data £;et being routed through the output stream. 
The maximum number that can be specified is 16777215. 

Rules for Coding 

1. The OUTLIM parameter has no meaning in systems with PCP; it has 
meaning in system.s with ¥iF1 or MVT only if the System 
Management Facilities option with system, jot, and step data 
collection was selected at system generation. 

2. The OUTLIM parameter is ignored unless S\SOUT is coded in the 
operand field of the same DD statement. 

3. The value specified for OUTLIM can be any nunber from 1 throuah 
16777215. 

4. If OUTLIM is not specified or if OUTLIt^=0 is specified, no 
output limiting is done. 

What the OUTLIM Parameter Does 

The OUTLIM parameter allows you to specify a limit for the number of 
logical records you want included in the output data set being 
routed through the output stream. When the number specified is 
reached, an exit provided by the System Management Facilities option 
is taken to a user supplied routine that determines whether to 
cancel the job or increase the limit. If the exit routine is not 
supplied, the job is cancelled. 

Determining the Output Limit 

The limit for the numiber of logical records you want as output must 
include a system overhead factor. Generally, the value you add to 
the limit is eight times the blocking factor for your data. (For 
those programmers who need a more precise value, the system overhead 
is the number of EXCPs issued each time the OPEN or CLOSE macro 
instruction is issued for the data set.) 

References ; 

1. For inform.ation on coding the SYS0I3T parameter on the DD 
statement, refer to the section "The SYSOUT PARAMETER — MFT , 
MVT" in this publication. 

2. A discussion of the System Management Facilities Option is 
contained in the publication Concepts and Facilities . 
Information on user exit routines to be used with the System 
Management Facilities Option is contained in the publication 
System Programmer's Guide . 

Example o£ the OUTLIM Parameter 

1. //OUTPUT DD SYSOUT=F,OUTLIM=1000 

The limit for the number of logical records is 1000. 
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The SEP Parameter 

SEP=(ddnaine, . . .) 

ddname 

the names of up to eight earlier DD statements in the same job 
step. 



Rules for Coding 

1. Each ddname must be separated by a comma. 

2. If only one ddname is coded, you need not enclose it in ^^^Bili] 
parentheses. 

3. If channel separation is critical, use the UNIT parameter to 
specify a particular channel, using an absolute address or group 
name. (How to specify a particular channel is described in the 
chapter "The UNIT Parameter.") 

U. The SEP, AFF, DDNAME, and SYSOUT parameters are mutually exclusive 
parameters; therefore, when AFF, DDNAME, or SYSOUT is coded, do not 
code the SEP parameter. 

OPTIMIZING CHANNEL USAGE 

The devices that the system allocates for data sets used in a job step 
are attached to channels. These channels transmit the data in the data 
sets from the device to the CPU. When two or more data sets are to be 
used in a job step, processing timie may be shortened if the system 
transmits data over separate channels. 



Requesting Channel Separation 

The SEP and AFF parameters can be used to request channel separation. 
You list in the SEP parameter the names of up to eight earlier DD 
statements in the job step that define data sets fromi which channel 
separation is desired. Coding the AFF parameter is a shortcut miethod of 
requesting channel separation, since you refer to an earlier DD 
statement in the same job step that contains the SEP parameter. (The 
AFF parameter is described in the chapter "The AFF Parameter.") 

In PCP, if the system finds it impossible in the current environment 
to satisfy the channel separation request, the request is ignored. 

In MET and MVT, if the system finds it impossible in the current 
environment to satisfy the channel separation request, the system may 
try to alter the current environment through some operator action. The 
operator is given the option of bringing a device online, cancelling the 
channel separation request, or cancelling the job. In certain 
environments, the operator may also be able to tell the system to wait 
for devices to become free. If you make a nonspecific request for a 
direct access volume and request channel separation, your request for 
separation may be ignored. This happens when the algorithm used to 
allocate data sets to devices is not able to select the device that 
would permit the desired channel separation. 
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Requests for channel separation are ignored for any data sets that 
have been allocated devices by the automatic volume recognition (AVR) 
option . 

If it is essential that data be transmitted via a particular channel, 
you can specify an absolute unit address or group name (if the group of 
devices is associated with one channel) in the UNIT parameter. 

If neither the SEP nor T^FF parameter is coded, any available channel, 
consistent with the UNIT parameter requirement, is assigned by the 
system. 



Example of the SEP Parameter 

1- //STEPl EXEC PGM=STARTS 

DSNAME=X.Y.Z,DISP=OLD 

DSNA]yiE=g&WORK,DISP=(,PASS) ,UNIT=2311, X 

SPACE=(CYL, (3,1) ) 

DSNAME=NABS , DISP=OLD , VOLUiy!E=SER=7110 , UNIT=2311 

DSNAME=PARE,DISP=CLD,VOLUME=SER=E59, X 

UNIT=2311 , SEP= (DD2 ,DD3) 

The system attempts to assign the data set defined by the DD 
statement named DDU to a channel other than the ones assigned to the 
data sets defined by the DD statements DD2 and DD3- Since the SEP 
parameter did not include the ddname DDl, the data set defined by 
DDl and the data set defined by DD4 may or may not be assigned to 
the same channel. 



//DDl 


DD 


//DD2 


DD 


// 




//DD3 


DD 


//DD4 


DD 


// 
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The SPACE Parameter 



SPACE = ( TRK 
CYL 
( blocklength 



, (primary quantity 



, secondary quantity 
.i'3 -I 



, directory 
, index 



,RLSE 



,CONTIG 

,MXiG 

,ALX 



[, round] 



I 



S PACE -(A BSTR, (primary quantity, address 



, directory 
, index 



SPACE=(ABSTR, (priitiary quantity , address , directory )) 

, index 



TRK 



specifies that space is to be allocated by track. 




CYL 



specifies that space is to be allocated by cylinder. 



block length 

specifies the average block length of the data. The system 
computes how many tracks to allocate., 

primary quantity 

specifies how many tracks or cylinders are to be allocated, or how 
many blocks of data are to be contained in the data set. 

, secondary quantity 

specifies how many more tracks or cylinders are to be allocated if 
additional space is required, or how many more blocks of data may 
be included if additional space is required. 



specifies that the system is not to allocate additional space if it 
is required, and either a directory space requirement or index 
space requirement follows. 

, directory 

specifies the niamber of 256-byte records that are to be contained 
in the directory of a partitioned data set. 

, index 

specifies the number of cylinders that are required for the index 
of an indexed sequential data set. 



,RLSE 



specifies that space allocated to the data set that is not used is 
to be released. 







specifies that space allocated to the data set that is not used is 
not to be released and another subparameter follows. 



,CONTIG 

specifies that space allocated to the data set must be contiguous. 



,MXIG 



specifies that the space allocated to the data set must be the 
largest area of contiguous space on the volumie and the space must 
be equal to or greater than the space requested. 
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,ALX 

specifies that up to five different contiguous areas of space are 
to be allocated to the data set and each area must be equal to or 
qreater than the space requested. 

['] 

specifies that CONTIG, KXIG, or ALX is not specified and the ROUND 

subparaineter follows. 

, ROUND 

specifies that space is requested by specfying tbe average jdIock 
length of the data and the space allocated to the data set must be 
equ£il to one or more cylinders. 

ABSTR 

specifies that the data set is to be placed at a specific location 
on the volume. 

primary quantity 

specifies the number of tracks to be allocated to the data set. 

address 

specifies the track number of the first track to Joe allocated. 

, directory 

specifies the number of 256-byte records that are to be contained 
in the directory of a partitioned data set. 

, index 

specifies the number of tracks that are required for the index of 
an indexed sequential data set. The number of tracks must be equal 
to one or more cylinders. 



Rules for Coding 

1. The SPACE parameter has no meaning for tape volumes; however, if a 
data set is assigned to a device class that contains both direct 
access devices and tape devices, e.g., U1S!IT=SYS3C: # the SPACE 
parameter should be coded. 

2. If you do not code secondary, directory, or index quantities, you 
need not enclose the primary quantity in parentheses. 

3. Code the second format of the SPACE parameter when you want a data 
set placed in a specific position on a direct access device. 

U. The SPACE, SPLIT, SUBALLOC, and DDNAME parameters are mutually 

exclusive parameters; therefore, if SPLIT, SUBALLOC, or DENANE is 
coded, do not code the SPACE parameter. 



REQUESTING SPACE FOR A DATA SET 

Every data set that is to be written on a direct access volume miust be 
allocated space on the volume before the data set can ce written. There 
are three different parameters that can be used to request space — 
SPACE, SPLIT, SUBALLOC -" and they are mutually exclusive. The SPLIT 
and SUBALLOC parameters are discussed in the chapters "The SPLIT 
Parameter" and "The SUBALLOC Parameter," respectively. 
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SPECIFYING THE SPACE PARAMETER 

Space for data sets is allocated before the job step is executed. It a 
request for space cannot be satisfied, the job is terminated. 

There are two different ways to code the SPACE parameter. One way 
tells the system how much space you want and lets the system assign 
specific tracks. The other way tells the system the specific tracks you 
want. 



Letting the System Assign Specific Tracks 

When you want the system to assign specific tracks, you must specify in 
the SPACE parameter: 

• The unit of measurement the system should use for allocating space; 
specify TRK, for tracks, CYL, for cylinders, or the average block 
length of the data, for blocks. 

• The amount of space to be allocated; specify the primary quantity as 
a number of tracks, cylinder, or blocks. 

Optionally, you can specify in the SPACE parameter: 

• That additional space is to be allocated to the data set if it is 
required; specify a secondary quantity of tracks, cylinders, or 
blocks. 

• The size of a directory or index area; specify the number of 
records required for a directory or the number of cylinders 
required for an index. 

• That unused space is to be released; specify the RLSE 
subparameter . 

• The format of the space allocated to the data set; specify the 
CONTIG, MXIG, or ALX subparameter. 

• That space is to begin with a cylinder; specify the ROUND 
subparameter . 

When a Disk Operating System (DOS) volume is miounted for use in an 
IBM System/360 Operating System, you can let the system, assign specific 
tracks on the DOS volume for a new data set. (There are restrictions on 
the use of an existing DOS data set in an lEM System/3 60 Operating 
System; these restrictions are described in the chapter "Maintaining the 
Catalog and the Volume Table of contents" in System Programmer's Guide .) 

SPECIFYING THE UNIT OF MEASUREMENT 

The first subparameter of the SPACE parameter identifies the unit of 
measurement to be used in allocating the data set and can be specified 
as : 

• TRK — if you want space allocated by track. 

• CYL — if you want space allocated by cylinder. CYL must be 
specified if you are creating an indexed sequential data set. 

• a number of bytes which represents the average block length of the 
data — if you want the system to compute and allocate the least 
number of tracks required to contain the blocks. 
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since the next subparameter (priirary quantity) tells the systeiri how 
many of these units you require, specify the unit that makes it most 
convenient for you to express your space requirement. A request for 
cylinders (CYL) provides the most efficient performance. 

when you request space in units of blocks, the average block length 
cannot exceed 65,535. If the blocks have keys, code the DCB 
subparameter KEYLEN on the CD statement and specify the key length, 
i.e., DCB=KEYLEN=key length. 

SPECIFYING A PRIMARY QUANTITY 

The primary quantity tells the system how many tracks or cylinders are 
to be allocated to the data set or how many blocks of data will be 
written. When the first subparameter of the SPACE parameter specifies 
the average block length, the system computes the number of tracks (or 
cylinders if the ROUND subparameter is coded) required based on the 
number of blocks specified as the primary quantity. 

There must be enough available space on one volume to satisfy the 
primary quantity. If you request that a particular volume be used and 
there is not enough available space on that volume to satisfy the space 
request, the job step is terminated. If you make a nonspecific volume 
request, i.e., no volume serial numbers are specified on the DD 
statement, the system selects a mounted volume or causes a volume to be 
mounted and then determines if there is enough space available on the 
volume to satisfy the request for space. If there is not enough space 
available, the system selects another voliame. 

The system attempts to allocate the primary quantity in contiguous 
tracks or cylinders. If contiguous space is not available, the system 
satisfies the space request with up to five noncontiguous blocks 
(extents) of space. You can override these system actions by coding the 
CONTIG, MXIG, or ALX subparameter; these subparameters are discussed 
later . 

SPECIFYING A SECONDARY QUANTITY 

The secondary guantity (incremental quantity) tells the system that you 
want additional space allocated to the data set if it is required. You 
specify as the secondary quantity how many more tracks or cylinders you 
want allocated or how many more blocks of data may be written. (When 
you request space in units of blocks, the system computes the number of 
tracks required for the primary quantity based on the average block 
length that you specified in the SPACE parameter. The system computes 
the number of tracks required for the secondary quantity based on what 
is specified in the DCB subparameter BLKSIZE. Therefore, include the 
DCB subparameter BLKSIZE on the DD statement, i.e., DCE=BLKSIZE=maximum 
block length.) Specifying a secondary quantity is optional. 

If you do specify a secondary quantity and the data set requires 
additional space, the system allocates this space based on the quantity 
you specified. The system attempts to allocate the secondary quantity 
in contiguous tracks or cylinders. If contiguous space is not 
available, the system attempts to allocate the secondary quantity in up 
to five noncontiguous blocks (extents) of space. 

Each time the data set requires more space, the system, allocates the 
secondary quantity. This space is allocated on the samie volume on which 
the primary quantity was allocated until: (1) there is not enough space 
available on the volume to allocate the secondary quantity, or (2) a 
total of 16 extents have been allocated to the data set. If either of 
these conditions is satisfied, the system must allocate the secondary 
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quantity on another volume. however, this can be done only if you 
request more than one volume in the VOLUME parameter (for a nonspecific 
volume request, code PRIVATE; for a specific volume request, request 
more volumes than devices) . 

If a data set has used all the primary space allocated to it, a later 
job step or job can lenqthen the data set with additional output only if 
a secondary quantity was specified when the data set was created and 
only if there is enough space available on the volume. If a later job 
step or job is lengthening a data set and specifies a secondary 
quantity, this quantity overrides, for tne; duration of the step, any 
secondary quantity specified when the data set was created. 

For indexed sequential data sets, a secondary quantity cannot be 
requested. Any secondary quantity requested for a checkpoint data set 
is ignored. 

The secondary quantity is a positional subparameter . If you specify 
a secondary quantity, the quemtity must follow the primary quantity. If 
you do not specify a secondary quantity and specify the size of an index 
or directory as the next subparameter, you must code a comma to indicate 
the absence of a secondary quantity. 



REQUESTING SPACE FOR A DIRECTORY OR INDEX 

If the data set you are creating is a partitioned data set, you must 
request the system to allocate space for a directory. A directory 
consists of 2b6-byte records, and you specify, in the SPACE parameter, 
how many of these records the directory is to contain. These records 
contain entries for the membe^rs of the partitioned data set. You can 
determine how many records you should request for the directory by 
referring to the chapter "Processing a Partitioned Data set" in the 
Supervisor and Data Management Services publication. 

If the data set you are creating is an indexed sequential data set, 
you can tell the system, in the SPACE parameter, how many cylinders to 
allocate for the index. (The alternate way to request space for the 
index is to include, as one of the DD statements used to define an 
indexed sequential data set, a DD statement that defines the index and 
specifies the number of cylinders required for the index as the primary 
quantity. ) 

The system can differentiate between a specification of the number of 
records for a directory and the number of cylinders for an index by 
examining the DCB parameter on the DD statement. Any DD statement that 
defines an indexed sequential data set must include the DCB subparameter 
DSORG=IS or DSORG=ISU. When neither is specified, the system assumes 
you are requesting space for a directory. 



RELEASING UNUSED SPACE — RLSE 

The RLSE subparameter allows you to request the system to delete unused 
space when the data set is closed. If you requested space in units of 
tracks, any unused tracks are released. If you requested space in units 
of cylinders, any unused cylinders are released. If you requested space 
in units of blocks, any unused tracks or cylinders, whicnever the system 
allocated to the data set, are released. 

If you code the SPACE parameter on a DD statement that defines an 
existing data set and include the RLSE subparameter, the data set's 
unused space is released. 
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The RLSE sutparameter is a positicnal sufcparaineter . If you omit the 
i<LSE subparameter and another suhparameter follows, inaicate the absence 
of the RLSE subparameter with a coirira. 

The RLSE subparameter is ignored when the TYPF=t option is coded in 
tne CLOSE macro instruction. 

SPECIFYING THE FORMAT OF ALLOCATED SPACE — CONTTG , iXXIG , OR ALX 

The system attempts to allocate space in contiguous tracks or cylinders. 
If contiguous space is not available, the system satisfies the space 
request with up to five noncontiguous blocks of space. You can override 
these system actions by coding the CCNTIG, MXIG, or ALX subparameter. 

The CONTIG (contiguous) supparameter tells the system that the space 
it allocates to a data set must be ccntiquous. If the request cannot be 
satisfied, the job is terminated. If secondary space is allocated to 
the data set, it may not be contiguous to the original space allocated 
to the data set. 

The MXIG (maximum contiguous) subparameter tells the system to 
allocate the largest area of contiguous space available on the volumie. 
The area must be at least as large as the primary quantity requested. 
The MXIG subparameter cannot be specified fcr an indexed sequential data 
set. 

The ALX (all extents) subparameter tells the systemi to allocate up to 
five different areas of contiguous space. Each area is to be at least 
as large as the primary quantity you requested. The system allocates as 
many areas as are available. The ALX subparameter cannot be specified 
for an indexed sequential data set. 

Whichever of these subparameters you cnoose must follow either the 
RLSE subparameter or the comima that indicates its absence. If you do 
not specify one of these subparameters and the ROUND subparameter 
follows, indicate the absence of the CONTIG, MXIG, and ALX subparameters 
with a commia . 

ALLOCATING WHOLE CYLINDERS — ROUND 

When you request space in units of blocks, you can request that the 
allocated space be equal to one or more cylinders. To request this, 
code ROUND as the last subparameter in the SPACE parameter. The system 
computes the number of tracks required to hold the blocks, and ensures 
that the space begins on the first track of a cylinder and ends on the 
last track of a cylinder. 



Assigning Specific Tracks 

You can place a data set in a specific position on a direct access 
volume by specifying in the SPACE parameter : 

• ABSTR as the first subparameter. 

• How many tracks you want allocated. 

• The relative track number of the beginning track on which you want 
the data set placed. 

If the data set is a partitioned data set, you must also specify how 
many records you want allocated for a directory. If the data set is an 
indexed sequential data set, you can also indicate how many tracks are 
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required for the index. (The number of tracks you specify must be equal 
to one or more cylinders, and any other DD statement used to define the 
indexed sequential data set must specify ABSTR in the SPACE parameter . 
If either of these conditions is not met, the job is terminated.) 

To determine the relative track number, count the first track of the 
first cylinder on the volume as 0, and count through the tracks on each 
cylinder until you reach the track on which you want your data set to 
start. (Track cannot be requested.) The system automatically 
converts the relative track number to an address; this address varies 
with different devices. For indexed sequential data sets, the relative 
track number must correspond to the first track on a cylinder. 
Capacities of a number of direct access devices are listed in "Data Set 
Disposition and Space Allocation" in the Supervisor and Data Management 
Services publication. 

If the tracks you request have already been allocated to another data 
set, the job is terminated. 

Since a secondary quantity cannot be coded with the ABSTR 
subparameter , the absolute track allocation technique cannot be used to 
create a multivolume data set. 



Examples of the SPACE Parameter 

1. //DDl DD DSNAME=&6TEMP,UNIT=MIXED,SPACE=(CYL,10) 

This DD Statement defines a temporary data set and requests the 
system to assign any available tape or direct access volume 
(UNIT=MIXED specifies a group name of units that consists of tape 
and direct access devices) . If a tape volume is assigned, the SPACE 
parameter is ignored; if a direct access volume is assigned, the 
SPACE parameter is used to allocate space to the data set. The 
SPACE parameter includes only the required subparameter s (i.e., the 
type of units and a primiary quantity) , and requests the system to 
allocate 10 cylinders. 

2. //DD2 DD DSNAME=ELLN,DISP=(,KEEP),UNIT=2314, X 
// VOLUME=SER=11257,SPACE=(1024, (100,25)) ,, ,HCU]S1D) , X 
// DCB=BLKSIZE=2 0U8 

This DD statement defines a new data set that is to be written on a 
direct access volumie. The SPACE parameter requests the system to 
compute the space required for the primary quantity; the system 
computes the space required based on an average block length of 102 4 
bytes, and up to 100 blocks of data will be written. If more space 
is required, the system is to comipute how much additional space to 
allocate; the system computes the space required based on a maximum 
block length of 2048 bytes (specified in the ELK3IZE subparamieter) , 
and up to 25 blocks of data will be written. Since the ROUND 
subparameter is coded, the system ensures that the allocated space 
begins on the first track of a cylinder and ends on the last track 
of a cylinder. 

3. //DD3 DD DSNAME=PDS12,DISP=(,KEEP) ,UNIT=2311, X 
// VOLUME=SER=26143,SPACE=(TRK, (200 , , 10) , ,CONTIG) 

This DD statement defines a new partitioned data set. The system 
allocates 200 tracks to the data set and 10 2b6-byte records for a 
directory. Since the CONTIG subparameter is coded, the system 
allocates 200 contiguous tracks on the volume. 
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4. //DDU DD DSNAME=INDSEQ ( INDEX) ,UNIT= 2314, DCB=DSORG=IS, X 

// DISP=(,KEEP) ,SPACE=(AESTR, (20,20)) 

This DD statement defines the index area for a new indexed 
sequential data set. The SPACE parameter allocates 2 tracks (for a 
231U, 20 tracks equal 1 cylinder), beginning with the twentieth 
track on the volume (the twentieth track on the voluire is the 
beginning of the second cylinder) . 
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The SPLIT Parameter 

SPLIT= I (n,CYL, (primary quantity [, secondary quantity])) 
n 

(percent, block length, (primary quantity [, secondary quantity)))] 
percent 



n 

the number of tracks per cylinder you want allocated to the first 
data set. 

CYL 

specifies that space is to be allocated by cylinder. 

primary quantity 

specifies how many cylinders are to oe allocated for use by all the 
associated data sets. 

, secondary quantity 

specifies how many more cylinders are to be allocated to a data set 
if additional space is required. 

n 

the number of tracks per cylinder you want allocated to the data 
set defined on the DD statement. 

percent 

the percentage of tracks per cylinder you want allocated to the 
first data set, a nuriiber from 1 through 99. 

block length 

specifies the average block length of the data. The system 
cpmiputes how many cylinders to allocate. 

primary quantity 

specifies the total number of blocks to be allocated for use by all 
the associated data sets. 

, secondary quantity 

specifies how many more blocks are to be allocated to a data set if 
additional space is required. 

percent 

the percentage of tracks per cylinder you want allocated to the 
data set defined on the DD statement. 




Rules for Coding 



1. The first DD statement that contains the SPLIT parameter must 
contain volume and unit information. You need not code volume and 
unit information on the following DD statements that contain the 
SPLIT parameter. 

2. If a secondary quantity is not specified, you need not enclose the 
primary quantity in parentheses. 

3. The SPLIT, SPACE, SUEALLOC , DDNM^E , and SYSOUT parameters are 
mutually exclusive parameters; therefore, if SPACL, SUBALLOC, 
DDNAME, or SYSOUT is coded, do not code the SPLIT parameter. 
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REQUESTING SPACE FOR A DATA SET 

Evejry data set that is to be written on a direct access volume iriust De 
allocated space on the voluire before the data set can Le written. There 
are three different paran.eters that can be used to request space — 
SPLIT, SPACE, SUBALLOC — and they are iTiUtually exclusive. The SPACE 
and SUBALLOC parameters are discussed in the chapters "The SPACE 
Parameter" and "The SUBALLOC Parameter," res^^ectively. 



Specifying the SPLIT Parameter 

The SPLIT parameter is specified when data sets defined in a job step 
require space on the same volume, and you want to minimize access-arm. 
movement by having the data sets share cylinders. The device on which 
the volume is mounted is said to be operatinq in a split cylinder mode 
when the SPLIT parameter is specified. In this mode, two or more data 
sets are stored so that portions of each data set occupy tracks within 
every allocated cylinder. 

The cylinders allocated to the data sets must De on one volumie. If 
there are not enough cylinders available on the volumie to satisfy the 
request, the job is terminated. The SPLIT parameter cannot be used to 
allocate space for direct, partitioned, and indexed sequential data 
sets. If the SPLIT paramieter is used to allocate space for data sets 
that are to resiae on a drum storage volume, space is allocated for the 
data sets, but the data sets are not stored using the split cylinder 
miode. The space occupied by a data set residing on a cylinder that has 
been split, is not available for reallocation until all data sets sharing 
the cylijider have been deleted. 

The data sets that are to share cylinders are defined by a sequence 
of DD statements. The first DD statement in the sequence specifies the 
total amount of space required for all the data sets and the portion of 
that space required by this data set. Each succeeding DD statement in 
the sequence requests a portion of the total space. 

In the SPLIT parameter, there are two ways to request the total 
amount of space for data sets that are to share cylinders. You can 
request the space in units of cylinders or in units of blocks, 

REQUESTING SPACE IN UNITS OF CYLINDEP.S 

When you request space in units of cylinders, the first DD statement ox 
the sequence specifies in the SPLIT parameter: 

» Tne number of tracks per cylinder to ioe allocated to this data set; 
specify a number. 

•a Space is to be allocated in units of cylinders; specify CYL. 

» How many cylinders are to be allocated for use by all the data sets; 
specify the primeiry quantity as a number of cylinders. 

Optionally, you can specify: 

« That additional cylinders are to be allocated to a data set if 
adaitional space is required; specify the secondary quantity as o 
number of cylinders. 

Each succeeding DD statement in the sequence specifies only the 
number of tracks per cylinder to be allocated to the data set. 
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If a secondary quanicity (incremental quantity) is specified in tnt 
SPLIT parameter on the first DD statement in the sequence, any data set 
that exceeds its allocated space is allocated additional space in the 
amount of the secondary quantity. This additional space is allocated 
only to the data set that requires it and the space is not split with 
the other data sets. If a secondary quantity is not specified and a 
data set exceeds its allocated space, the job step is terminated. 

REQUESTING SPACE IN UNITS OF BLOCKS 

When you request space in units of blocks, the first DD statement of the 
sequence specifies in the SPLIT parameter: 

• The percentage of tracks per cylinder to be allocated to this data 
set; specify a number from 1 to 99. 

• Tne average block length of the data in the data sets; specify the 
average block length in bytes. 

• How many blocks are to be allocated for use by all the data sets; 
specify the primary quantity as a number of blocks. 

Optionally, you can specify: 

• That additional blocks are to be allocated to a data set if 

additional space is required; specify the secondary quantity as a 
number of blocks . 

Each succeeding DD statement in the sequence specifies only the 
percentage of tracks per cylinder to be allocated to the data set. 

When you request space in units of blocks, the system comiputes for 
you how many cylinders are required. The average block length cannot 
exceed 65,535 bytes. If the blocks have keys, code the DCB subparameter 
KEYLEN on the DD statement and specify the key length, i.e., 
DCB=KEYLEN=key length. 

If a secondary quantity (incremental quantity) is specified in the 
SPLIT parameter on the first DD statement in the sequence, any data set 
that exceeds its allocated space is allocated additional space. The 
secondary quantity is specified as a number of clocks, and the system 
computes how many cylinders to allocate based on this number. This 
additional space is allocated only to the data set that requires it and 
the space is not split with the other data sets. If a secondary 
quantity is not specified and a data set exceeds its allocated space, 
the job step is termdnated. 
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//STEPl 


EXEC 


//DDl 


DD 


// 




//DD2 


DD 


//DD3 


DD 



Examples o£ the SPLIT Parameter 

PGM=CREATE 

DSNAME=QUEST,DISP=(,KEEP) , UNIT=2311 , X 

VOLUME=SEK=757500,SPLIT= (3,CYL, (30,1) ) 

DSNAME=APP , DISP= ( , KEEP ) , SFLIT=U 

DSNAME^SET , DISP= ( , KEEP ) , SPLIT= 3 

This job step contains a sequence of DD stateirents that define new 
data sets and request that these data sets share the saire cylinders. 
Tne first DD statement of the sequence, naroed DDl, specifies: (1) 
three tracks per cylinder are to be allocated to this data set; (2) 
space is to pe allocated in units of cylinders; (3) thirty cylinders 
are to be allocated for use by all the data sets; and (4) any data 
set that exceeds the space allocated to it should be allocated 
another cylinder. The DD statement named ED2 requests that the 
system allocate U tracks per cylinder to this data set. The DD 
statement named DD3 requests that the system allocate 3 tracks per 
cylinder to this data set. 

2. //STEP2 EXEC PGM=PAGE 

DSNAME=IS3A,DISP=(,KEEP) ,UNIT=2314, X 

VOLUME=SER=U9463,SPLIT=(18,102U, (700) ) 
DSNAME=3EL12,DISP=^(,KEEP) ,SPLIT=U8 
DSNAME=SEVE,DISP= (,KEEP) ,SPLIT=3U 

This job step contains a sequence of DD statements that define new 
data sets and request that these data sets share the same cylinders. 
The first DD statement of the sequence, nam.ed DDX, specifies in the 
SPLIT parameter: (1) 18 per cent of the tracks per cylinder are to 
be allocated to this data set; (2) the system is to compute how many 
cylinders are to be allocated for use by all the data sets based on 
an average block length of 102 U bytes and 700 blocks are required. 
The DD statement named DDY requests that the system: allocate 4 8 per 
cent of the tracks per cylinder to this data set. The DD statement 
named DDZ requests that the system allocate 3 4 per cent of the track 
per cylinder to this data set. Since the first DL statement in the 
sequence does not specify a secondary quantity, the job is 
abnormally terminated when any of the data sets exceeds its 
allocated space. 



//STEP 2 


EXEC 


//DDX 


DD 


// 




//DDY 


DD 


//DDZ 


DD 
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The SUBALLOC Parameter 



SUBALLOC = (( TRK 
CYL 
( blocklength 



, (primary quantity 



, secondary quantity 



][■ 



:tory j ) 



,ddname 

,stepname.ddname 

,stepname.procstepname.ddname 



TRK 



speciifes that space is to be allocated by track. 



CYL 



specifies that space is to be allocated by cylinder. 



ialock length 

specifies the average block length of the data. The system 
computes how many tracks to allocate., 

primary quantity 

specifies how many tracks or cylinders are to be allocated, or how 
many blocks of data are to be contained in the data set. 

, secondary quantity 

specifies how many more tracks or cylinders are to be allocated if 
the additional space is required, or how many more blocks of data 
may be included if additional space is required - 

specifies that the system is not to allocate additional space if it 
is required, and a directory space requirement follows. 

, directory 

specifies the niimber of 256-byte records that are to be contained 
in the directory of a partitioned data set. 

, ddname 

specifies that the system must allocate space from the data set 
defined on the earlier DD statement named "ddnane" that appears in 
the same job step. 

, stepname . ddname 

specifies that the system must allocate space from the data set 
defined on the DD statement named "ddname" , which is contained in 
an earlier job step named "stepname" that is part of the same job. 

, stepname . procstepname . ddname 

specifies that the system must allocate space from the data set 
defined on the DD statement "ddname," which is contained in an 
earlier procedure step named "procstepname"; the procedure step is 
part of a cataloged procedure called by an earlier job step named 
"stepname" that is part of the same job. 




vm 
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Rules for Coding 

1. Before you can use the iatlBALLOC parameter, you irust define a nev« 
data set and request enough space in the SPACE parameter to contain 
all of the data sets. 

2. When you code the SUBALLOC parameter, crrit the VCLULAE and UNIT 
parameters. 

3. The SUBALLOC, SPACE, SPLIT, DDNAME, and SilSOUT parameters are 
mutually exclusive parameters; therefore, when SPACE, SPLIT, 
DDNAhE, or SYSOUT is coded, do not coae tne SUBALLOC parameter. 

REQUESTING SPACE EOR A DATA SET 

Every data set that is to be written on a direct access volume must ce 
allocated space on the volume before the data set can ioe written. There 
are three different paramieters that can be used to request space -- 
SUBALLOC, SPACE, SPLIT — and they are mutually exclusive. The SPACE 
and SPLIT parameters are discussed in the chapters "The SPACE Paramieter" 
and "The SPLIT Parameter," respectively. 

Specifying the SUBALLOC Parameter 

The SUBALLOC parameter allows you to place a series of data sets on one 
volume and in a certain sequence, in a contiguous area of space. This 
area of space is first allocated to one data set, then later DD 
statements defining new data sets in the same job may request parts of 
this space. This is called suballocation. Sufcallocation is used to 
minimize access-arm movement when data sets are processed serially. Tbe 
SUBALLOC parameter cannot be used to allocate space for an indexed 
sequential data set. 

To use suballocation, you must first define a data set on a DD 
statement and use the SPACE parameter to request space. This data set 
must be used only for suballocation purposes, i.e., the data set should 
contain no data. The space you request must be large enough to contain 
all of the data sets and the space must be contiguous. On this same DD 
statement, you can request more than one device in the UNIT paraneter or 
m.ore than one volume in the VOLUiVlE parameter. This allows a 
suballocated data set for wnicn a secondary quantity was requested in 
the SUBALLOC parameter to be continued on another vclune if the data set 
exceeds its primary quantity. 

Once this data set has been defined, other data settj defined in the 
job can use the previously allocated space by specifying the SUBALLOC 
parameter. Each DD statement that specifies the SUBALLOC parameter 
causes the new data set to be assigned to the next area of unused space 
from the original data set. 

You must specify in tne SUBALLOC parameter: 

• The unit of measurement the systemi should use for allocating space; 
specify TkK, for tracks, CYL, for cylinders, or tne average block 
length of the data, for blocks. 

• The amount of space to be allocated; specify the primary quantity as 
a number of cylinders, tracks, or blocks. 

• where in tne job the original data set is defined • Sj_ ecif y tne name 
of the DD statement that defines the data set and the name of the 
job step in which the DD statement appears. 
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Optionally, you can specify in the SUEALLOC parameter: 

• That additional space is to be allocated to the data set if it is 
required; specify a secondary quantity of tracks, cylinders, or 
blocks. 

• The size of a directory; specify the number of records required 
for a directory. 



SPECIFYING THE UNIT OF MEASUREMENT 

The first subparaineter of the SUEALLOC parameter identifies to the 
system the unit of mieasurement to be used in suballocating space fcr the 
data set and can be specified as: 

• TRK — if you want space suballocated by track. 

• CYL — if you want space suballocated by cylinder. 

• a number of bytes, which represents the average block length of 
the data — if you want the system to compute and allocate, the 
least number of tracks required to contain the blocks. 

Since the next subparameter tells the system how many of these units 
you require, specify the unit that makes it most convenient for you to 
express your space requirement. A request for cylinders (CYL) provides 
the most efficient performance. 

When you request space in units of blocks, the average clock length 
cannot exceed o5,535 bytes. If the blocks have keys, you must specify 
the key length in the DCB subparameter KEYLEN=n. 



SPECIFYING A PRIMARY QUANTITY 

The primary quantity tells the system how many tracks or cylinders are 
to be suballocated for the data set or how many blocks of data will be 
written. If there is not enough space available in the original data 
set to satisfy the primary quantity request, the job is terminated. 
When the first subparameter of the SUEALLOC parameter specifies the 
average block length, the system computes the number of tracks required 
based on the number of blocks specified as the primary quantity. 



IDENTIFYING THE ORIGINAL DATA SET 

Since you want space suballocated froiri a particular data set, you must 
identify this data set each time space is to be suballocated for a new 
data set. You identify this data set by referring the system to the DD 
statement that originally defines the data set. This DD statement must 
iDe contained in the same job, and can appear in the sam,e job step, an 
earlier job step, or in a procedure step that is part of a cataloged 
procedure called by an earlier job step. Code as the last subparameter 
in the SUEALLOC parameter: 

• ddname — if the DD statement appears in the same joiD step. 

• stepname. ddnamie — if the DD statement appears in an earlier job 
step. 

• stepnam.e. procstepname. ddname -- if the DD statement appears in a 
procedure step that is part of a cataloged procedure called by an 
earlier job step. 
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SPECIFYING A SECONDARY QUANTITY 

The secondary quantity (incremental quantity) tells the system that you 
want additional space allocated to the data set if it is required. You 
specify as the secondary quantity how many more tracks or cylinders you 
want allocated or how many more blocks of data may be written. (VJhen 
you request space in units of blocks, the system: computes the number of 
tracks required for the primary quantity based on the average block 
length that you specified in the SPACE parameter. The system computes 
the number of tracks required for the secondary quantity based on what 
is specified in the DCB subparamieter BLKSIZE. Therefore, include the 
DCB subparameter BLKSIZE on the DD statement, i.e., DCE=BLKSIZE=m,axim.um 
block length.) Specifying a secondary quantity is optional. 

If you specify a secondary quantity and the data set requires 
additional space, the system allocates this space based on the quantity 
you specified. This additional space is allocated from available space 
on the volume, not from the space in the original data set from which 
the system suballocated space for this data set. If miore than one 
device or volume was requested on the same DD statemient that requested 
space for suballocation, the data set can be continued onto another 
volume. 

A data set may use all the space allocated to it and a later job step 
or job may then try to lengthen the data set with additional output. In 
this case, the data set can be lengthened only if a secondary quantity 
was specified when the data set was created and only if there is enough 
space available on the volume. If a later job step or job is 
lengthening a data set and specifies a secondary quantity, this quantity 
overrides, for the duration of the step, any secondary quantity 
specified when the data set was created. 

The secondary quantity is a positional subparameter. If you specify 
a secondary quantity, the quantity must follow the primary quantity. If 
you do not specify a secondary quantity and specify the size of a 
directory as the next subparameter, you must code a comma to indicate 
the absence of a secondary quantity. 

KEgUESTING SPACE FOE A Dli^ECTOi^Y 

If the data set you are creating is a partitioned data set, you must 
request that the system, allocate space for a directory. A directory 
consists of 2 56-byte records and you specify hew many of these records 
the directory is to contain. These records contain entries for the 
members of the partitioned data set. You can determine how many records 
you should request for the directory by referring to the chapter 
"Processing a Partitioned Data Set" in the Supervisor and Data 
Management Service s publication. 

If you request space for a directory in the SUBALLOC parameter, the 
request must follow the secondary quantity or the comimia that indicates 
its absence. 



196 JCL Reference 



Examples o£ the SUBALLOC Parameter 



//STEPl 


EXEC 


//DDl 


DD 


// 




//STEP2 


EXEC 


//DD2 


DD 


// 




//DD3 


DD 


// 




//DD4 


DD 


// 





PGM=PKEP 

DSNAME=DUM,DISP=(,KEEP) ,UNIT=2302, 

VOLUME^SER=^ALLDS , SPACE= ( CYL ,bO, , CONTIG ) 

PGM=BSPED 

DSNAME=SFEC50,DISP=(,KEEP) , 

SUBALLOC=(CYL, (20,1) , STEPl. DDl) 

DSNAME=SFEC51,DISP=(,KEEP) , 

SUBALLOC=(TRK, (44,7) ,STEFl.DDl) 

DSNAME=SFEC52,DISP=(,KEEP) , 

SUBALLOC= (CYL, 2 5 , STEPl .DDl) 



The data set froni which space is to be suballocated is defined on 
the DD statement named EDI in STEPl. Fifty cylinders are allocated 
to the data set and the cylinders are contiguous. The DD stateirents 
named DD2, DD3, and DDU in STEP2 request a portion of this space in 
the SUBALLOC parameter by referring the system to the data set 
defined on the DD statement namied DDl in STEPl. Tne order of the 
data sets on the volume, because of the request for sutallocation, 
will be DUM, SPEC50, SPECSl, and SPEC 52. 




//STEPX 


EXEC 


//DD5 


DD 


// 




//DD6 


DD 


// 




//STEPY 


EXEC 


//DD7 


DD 


// 





2. //STEPX EXEC PGM=GARV 

DSNA]y!E=SlMP,DISP=(,KEEP) ,UNIT=2311, X 

VOLUM£=SER= 315046, SPACE= (CYL ,100,, CONTIG) 

DSNAME=fIELD,DISP=(,KEEP) , X 

SU3ALLOC=(1024, (800, 60) ,DD5) 

PGM=BERSS 

DSNAME=PDS,DISP=(,KEEP) , X 

SUBALLOC= ( CYL , ( 7 5 , , 8 ) , STEPX . DD 5 ) 

The data set from which space is to be suballocated is defined on 
the DD statement named DD5 in STEPX. One hundred cylinders are 
allocated to the data set and the cylinders are contiguous. The DD 
statement named DD6 requests a portion of this space in units of 
blocks. The system computes how many tracks or cylinders are 
required for the data set. The DD statement named DD7 in STEPY also 
requests a portion of the space allocated to the data set defined on 
the DD statement named DD5 in STEPX. The DD statement named DD7 
defines a partitioned data set and requests the systemi to allocate 8 
256-byte records for a directory. 
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The SYSOUT Parameter-PCP 

£3YSOUT=cla3snanie 

classname 

the class associated with the output device to vihich you want to 
write your output data set. 

Rules for Coding 

1. The classname can be any alpharreric character (A-Z, 0-9). 

2. The DCB parameter can be coded with the Sl^SOUT parau.eter to 
complete the data control block. Besides the mutually exclusive 
parameters listed below, other parameters coded with the SY3CUT 
parameter are ignored. 

3. The DISP, DDNAME, AFF, SEP, VOLUKE , LABEL, SPLIT, and SUBALLOC 
parameters and the SYSCUT paramieter are mutually exclusive 
parameters; therefore, if any of these parameters are coded, do not 
code the SYSOUT parameter. 



Advantages to Coding the SYSOUT Parameter 

When you want a data set printed on an output listing or in the form ot 
punched cards, you can code the UNIT parameter and identify the unit 
record device you want or code the SYSOUT parameter and specify the 
class that corresponds to the type of unit record device you want. 
There are advantages to coding the SYSOUT parameter: 

1. The unit is selected by the operator and can be identified to the 
system while your job step is executing. If a unit record device 
is temporarily not available, the operator can select an available 
tape unit and the output data set is written on a tape volume. 
Later, the operator has the data set written to the desired unit 
record device. 

2. The output data set and system messages resulting from the job can 
be printed in chronological order on a single output listing. 

THE CLASSNAWE 

When you code the SYSOUT param.eter, you indicate a classname. A 
classname is an alphameric character (A-Z, 0-9) that corresponds to a 
type of unit record device. Each installation specifies what classnames 
correspond to what unit record devices during system generation. 
Therefore, when you specify a classname, the operator knows what type of 
unit record device you want, and he ensures that the device is 
available. If the device is not available and the operator causes the 
output data set to be written on a tape volume, he ensures that the data 
set is later written to the device you want. 

The classname A is considered to be the standard output class and 
corresponds to a printer. The standard output class is used by the 
system to write system, messages resulting from, a job. Therefore, if you 
want your output data set and system messages resulting from the job to 
appear as a single listing, you simply code SYSOUT=A. 
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JOB SEPARATORS 

Your output data set is preceded by a job separator if your installation 
incorporated routines to write job separators. A job separator is a 
series of three listing pages or three punched cards that separates the 
output data sets of different jobs. These jobs wrote their output data 
sets to the same class. Each page or card contains the name of the job 
whose data follows, and identifies the output class. Job separators 
make it easier for the operator to separate the data produced by your 
job from the data of other jobs. 



Examples o£ the SYSOUT Parameter for POP 

1. //DDl DD SYSOUT=M 

This DD statement requests use of a particular type of unit record 
device. If the unit is not already available, the operator makes 
the unit available while the job step is executing or causes you to 
write the output data set on a tape volume. If the data set is 
written on a tape volumie, the operator has the data set written to 
the desired unit at a later time. 

2. //DD2 DD SYSOUT=A 

This DD statement requests use of the printer that corresponds to 
the standard output class. The processing program writes the data 
set and the system writes the system messages on the same output 
listing. 

3. //DD3 DD SYS0UT=G,DCB=Pi<TSP=2 

This DD statement requests use of a particular type of unit record 
device. Since the DCB subparameter PKTSP indicates line spacing foa: 
a printer, the classnarae G should correspond to a printer. 
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The SYSOUT Parameter-MFT, MVT 

SYSOUT= (classname f, program namen [,forir number]) 

classnaine 

the class associated with the output device to which you want your 
output data set written. 

, program name 

the member name of a program in the system library that is to write 
your output data set, instead of the system output writer, to a 
unit record device. 

specifies that the system output writer is to write your output 
data set to a unit record device, and a form number follows. 

, form number 

specifies that the output data set should be printed or punched on 
a special output form. 



Rules for Coding 

1. The classname can be any alphameric character (A-Z, 0-9). 

2. The form number is 1 to 4 alphameric and national (3,4J,#) 
characters. 

3. If a program name and form niomber are omitted, you need not enclose 
the classname in parentheses. 

4. The UNIT, SPACE, OUTLIM, and DCB parameters can be coded with the 
SYSOUT parameter. Besides the mutually exclusive parameters listed 
below, other parameters coded with the SYSOUT parameter are 
ignored. 

5. The DISP, DDNAME, AFF, SEP, VOLUME, LAEEL, SPLIT, and SUBALLOC 
parameters and the SYSOUT parameter are mutually exclusive 
parameters; therefore, if any of these param.eters are coded, do not 
code the SYSOUT parameter - 



Advantages to Coding the SYSOUT Parameter 

when you want a data set printed on an output listing or in the form of 
punched cards, you can code the UNIT parameter and identify the unit 
record device you want, or code the SYSOUT parameter and specify the 
class that corresponds to the type of unit record device you want. 
There are advantages to coding the SYSOUT parameter: 

1. You can write your output data set to a direct access device and a 
system output writer writes the data set to a unit record device at 
a later time. This allows greater flexibility in scheduling print 
and punch operations, and improves operating system efficiency. 
You can also write your output data set directly to a unit record 
or magnetic tape device. 
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2. The output data set and system messages resulting froiii the job can 
be assigned to the same type of unit record device. This is 
accomplished by specifying the same classnaire in the SYSOUT and 
Iv^SGCLASS parameters. (The i^SGCLASS parameter is coded on the JOB 
statement. ) 

3. When you want the output data set printed or punched en a special 
output form, you can specify the form number in the SYSOUT 
parameter and let the systemi inform the operator at the time the 
data set is to be written what form is to be used. 

THE CLASSNA^^E 

When you code the SYSOUT parameter, you indicate a classname. A 
classnamt? is an alphameric character (A-Z, 0-9) that corresponds to a 
type of unit record device. Each installation specifies what classnames 
correspond to what unit record devices. Therefore, when ycu specify a 
classnamie, the operator knows what type of unit record device you want 
and he ensures that a system output writer is available to write your 
output data set to the desired unit record device. 

In MFT and MVT, the system determines where system messages resulting 
from a job are to be written based on what is coded in the MSGCLASS 
parameter on the JOB statement. If the MSGCLASS parameter is not coded, 
systemi messages associated with your job are routed to the default 
output class specified in the PARM field of the input reader procedure. 
The default for the MSGCLASS parameter is A unless changed by your 
installation. Class A corresponds to a printer. If you want your 
output data set and the system messages resulting fron, the job written 
to the same unit record device, you simply code the same classname in 
both the MSGCLASb and SYSOUT parameters, or emit tne I^iSGCLASS parameter 
and code your installation's default output class in the SYSOUT 
parameter . 



THE PROGRAM NAME 

The system provides system output writers, which transfer your output 
data set from a direct access volume to the desired unit record device. 
If there is a special installation program to handle this transfer, you 
can use this program, instead of a system output writer, by specifying 
the program's name as the second subparaneter in the SYSOUT parameter. 
The program must be a memiber of the system library (SYSl.LINKLIB) . 

If you do not code a program name and code a form number as the last 
subparameter in the SYSOUT parameter, you must code a comma to indicate 
the absence of a program name. 



THE FORM i.^ UMBER 

Each installation provides standard forms to contain printed or puncned 

output. If there is a special output form you want to use, you can 

specify the form number as the last subparameter in the SYSOUT 

parameter. The system issues a message to the operator at the time the 

data set is to be printed or punched, which informis himi of the form to 

be used. If you do not want system miessages resulting fromi the job to 

appear on the special form, assign a classname in the MSGCLASS parameter 

on the JOB statement that is different from tne classname assigned in ^jups. 

the SYSOUT parameter. 
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CODING OTHER PARAJViETEftS WITH THE SYSOUT PARAMETEi< 

The UNIT, SPACE, OUTLIM and DCB parameters can be coded viith the SiSOUT 
parameter. The DDNARE, DISP, AFF, SEP, VOLUME, LABEL, SPLIT, and 
SUBALLOC parameters are mutually exclusive with the SYSOUT parameter; 
any other paramieters that you code with the SYSOUT parameter are 
ignored. 

In JVjFT and lyJVT, you can write output data sets destined for unit 
records devices to a direct access device instead of immediately writing 
the data set to the desired unit record device. Later, a system output 
writer writes the data set to the desired unit record device. In the 
UNIT parameter, you can request what type of direct access device you 
want for writing the output data set, how m^any devices you want (up to a 
maximium of five) , and unit separation from other data sets defined in 
the job step. In the SPACE parameter, you can specify how much space 
should be allocated to the data set and that unused space is to be 
released. If you omit the UNIT parameter, the system assigns a device; 
if you omit the SPACE parameter, the system assigns the amount of space 
to be allocated. These values are part of the PARM parameter field in 
the input reader procedure used to read the input stream. 

In ^JFT and MVT, you can also write an output data set directly to the 
desired unit record or magnetic tape device. When direct system, output 
is desired, the operator selects a unit record or magnetic tape device 
for a class by issuing a STAJxT DSO (direct system output) command. In 
addition to the SYSOUT parameter, the DCB and UCS parameters can be 
coded. If the SYSOUT subparameters other than classname are coded, the 
specified information is ignored. The UNIT and SPACt parameters are 
also ignored if direct system output processing is used. Since the type 
of processing to be used may not always be known, it is advisable to 
code these parameters in case an intermediate direct access device is 
used. 

The DCB parameter can be coded with tne SYSCUT parameter to complete 
the data control block associated with tne output data set. The 
information contained in this data control block is used when the data 
set is written to the direct access device and read by the system output 
writer. However, the output writer's own DCE attributes are used when 
the data set is written to the desired unit record device. 

The OUTLIM parameter allows you to specify a limit for the number of 
logical records you want included in the output data set being routed 
through the output stream. The OUTLIM paramieter has mieaning only in 
systems with the System Management Facilities option with system, joD, 
and step data collection. Unless the SYSOUT parameter is coded in the 
operand field of the same DD statement, the OUTLIM parameter is ignored. 



JOB SEPARATORS 

Your output data is preceded hy a job separator if your installation 
incorporated routines to write job separators. A job separator is a 
series of three listing pages or three puncned cards that separates the 
output data sets of different jobs. The output data sets from, these 
jobs were written to the same unit. Laca page cr card contains the name 
of the job whose data follows, and identifies the output class. Job 
separators make it easier for the operator tc separate the data produced 
by your job from the data of other jobs. 
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Examples o£ the SYSOUT Parameter for MFT and MVT 

1. //DDl DD SYSOUT=P 

This DD statement specifies that the data set is to re written to 
the unit record device corresponding to class P. Since the UNIT and 
SPACE parameters are not coded, the systerri obtains device and space 
allocation information from the input reader procedure. A 

2. //JOB50 JOE ,'C. BROVvN • , MSGCLASS=C 
//STEPl EXEC PGM=SET 

//DDX DD SYS0UT^C,DCB={BUFM0=4,0PTCD=W) 

The DD Statement named DDX specifies that the data set is to be 
written to the unit record device corresponding to class C. The DCB 
parameter is coded to coraplete the data control block associated 
with this data set. Since the classnames in the SYSOUT parameter 
and the M3GCLASS parameter, on the JCB statement, are the same, the 

CODING OTHER PARAMETERS WITH THE SYSOUT PARAMETER WRITTEN TO THE 
SAME UNIT RECORD DEVICE. 

3. //DD5 DD SYSOUT=A,UNIT=2314,SPACE=(CYL, (12,1) , ELSE) 

This DD statement specifies that the data set is to be written to 
the unit record device corresponding to the standard output class A. 
The system assigns a 2314 unit and allocates 12 cylinders to the 
data set, rather than obtaining device and space allocation 

4. //DB6 DD SYSOUT=(F, ,7402) 

This DD statement specifies that the data set is to ce written to 
the unit record device corresponding to class F and the output data 
set is to be printed on a special form. The form number is 7402. 
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The UCS Parameter 



UCS=( character set code rFOLin [, VERIFY] ) 



character set code 

identifies the special character set you want for printing the data 
set. 

, FOLD 

specifies that you want the chain or train corresponding to the 
desired character set loaded in the fold ircde. 

specifies that the chain or train is net to be loaded in the fold 
inode and the VERIFY sutparameter follows. 

, VERIFY 

specifies that the operator is to verify that the correct chain or 
train is mounted before the data set is printed. 

Rules for Coding 

1. The character set code can be 1 through 4 characters. 

2. If the FOLD and VERIFY subparameters are oiritted, you need not 
enclose the character set code in parentheses. 

3. If the UCS paraiTieter is coded and the data set is not written to a 
1403 printer with the universal character set (UCS) feature, the 
UCS parameter is ignored. 

4. The UCS and DDNAl^ parameters and the DCB subparameters RKP, 
CYLOFL, and INTVL are mutually exclusive parameters; therefore, if 
the DDNAME parameter or one of the DCB subparameters RKP, CYLOFL, 
or INTVL is coded, do not code the UCS parameter. 



Special Character Sets 

During system generation, the universal character set (UCS) feature can 
be reguested for a 1U03 printer. With this feature, an output data set 
written to the 1403 printer can be printed using a special character 
set. 

In the UCS parameter you specify what character set you want to use; 
the operator ensures that the corresponding chain or train is mounted on 
the 1403 printer. In order to use a particular special character set, 
an image of the character set must be contained in SYSl.SVCLIB and the 
chain or train corresponding to the character set must be available for 
use. IBM provides standard special character sets and tne installation 
may provide user-designed special character sets. How to include the 
images for these special character sets in SYSl.SVCLIB is discussed in 
the System Programmer's Guide . 

If you omit the UCS parameter and the data set is written to a 1403 
printer with the UCS feature, a default character set is used. If the 
chain or train mounted on the; printer does net correspond to a default 
character set, the operator is requested to identify a default character 
set and mount the corresponding chain or train. 
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Note ; When the DCS parameter is coded with the SYSOUT parameter and the 
data set is first written to tape, the UCS specification is not kept. 
Therefore, when the operator writes the data set from the tape to a 1403 
printer, you data set may not be written using the desired character 
set. 



IDENTIFYING TBE CHARACTEK SET 

The first subparameter of the UCS parameter identifies the character set 
you want for printing your data set. Each character set has a unique 1- 
through 4- byte code. 

The codes for the IBM standard special character sets are: 

AN — alphameric 

HN — alphameric 

PCAN — alphameric* 

PCHN — alphameric* 

PN — alphameric (PL/I) 

QNC — alphameric (PL/I-corrmerciaD* 

QN ■ — alphameric (PL/I-scientif ic) * 

RN — FORTRAN-COBOL (commercial)* 

SN — text printing* 

TN — text printing 

XN — high-speed alphameric 

YN — high-speed alphameric* 

♦Preferred character set 

For each user-designed special character set, the installation 
assigns a unique code. If you want to use one of these, specify the 
corresponding code in the UCS parameter. Ycu can use the space that 
follows to list the codes assigned to user-designed special character 
sets available at your installation. 
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REQUESTING FOLD MODE 

FOLD can be coded as the second subparaireter of the DCS parameter and 
requests the fold mode. The fold mode is descriced in the publication 
IBi^j 28 21 Control Unit , GA24-3112. The fold node is Kiost often requested 
when uppercase and lowercase data is to be printed only in uppercase. 

The FOLD subparameter is a positional subpara^Teter . If you omit the 
FOLD subparameter and code the VERIFY subparameter, you must code a 
comma to indicate the absence of FOLD. 

REQUESTING OPERATOR VERIFICATION 

VERIFY can be coded as the last subparam.eter of the UCS parmeter and 
requests that the operator visually verify that the character set imaae 
corresponds to the graphics of the chain or train that was mounted. 
When VERIFY is coded, the character set image is displayed on the 
printer so that the operator can make the verification before the data 
set is printed. 



Examples of the UCS Parameter 

1. //DDl DD UNIT=mO 3, UCS=(YN,, VERIFY) 

Tnis DD statement defineis an output data set that is to be written 
to a 1403 printer. The UCS parameter requests tnat the data set be 
written using the chain or train corresponding to the special 
character set with the code YN. Since VERIFY is coded, the 
character set image is displayed on the printer before the data set 
is printed. 

2. //DD2 DD SYS0UT=G,UC3=FCHN 

This DD statement defines an output data set that is to be written 
to the unit record device that corresponds with class G. If the 
device is a 1U03 printer with the universal character set, the 
request in the UCS parameter for the special character set with the 
code PCHN is recognized. Otherwise, the UCS parameter is ignored. 
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The UNIT Parameter 



UNIT= ( 



unit address 
device type 
group name 



,unit count 



[, DEFER J [,SEP=(ddnanie, . . . ) ]) 



L 

UNIT=AFF=ddnaine 

unit address 

identifies a particular unit by its address, which consists of the 
channel, control unit, and unit numbers. 

device type 

identifies a particular type of device. 

group name 

identifies a particular group of devices. The group name and the 
devices that make up a group are specified during system 
generation. 

,unit count 

indicates the number of devices you want assigned to the data set. 

,P 

specifies that each volume on which the data set resides is to be 
assigned a device. 

specifies that only one device is required and another subparameter 
follows. (If the DEFER subparameter is not coded but the SEP 
parameter is coded, this comma is optional.) 

, DEFEi< 

specifies that the system should assign a device (s) to the data set 
but the volume (s) on which the data set resides should not be 
mounted until the data set is opened. 

, S£P= 

indicates that this data set is to be assigned a different direct 
access device than the devices assigned to certain other data sets, 
i.e., unit separation. 

(ddname, . . . ) 

the names of up to eight earlier DD statements in the job step that 
define data sets from which you want unit separation. 

AFF= 

indicates that the system should assign tne data set to the same 
device (s) as assigned to another data set, i.e., unit affinity. 

ddname 

the name of an earlier DD statement in the job step that defines a 
data set with which you want unit affinity. 




Rules for Coding 

1. If the only subparameter coded in the UNIT parameter is the first 
subparameter, you need not enclose it in parentheses. 
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If the SEP subparameter is the only subparameter you are coding in 
the UNIT parameter, code UNIT- ( ,SEP= (ddnaire, . . . ) ) . 

If the list of ddnanies consists of only one ddname, you need not 
enclose it in parentheses. 

You need not code the unit count subparameter if you want only one 
device assigned to the data set. 

The UNIT and DDNAME parameters are mutually exclusive parameters; 
therefore, if DDNAME is coded, do not code the UNIT parameter. 



Providing Unit Information 

Before the data set can be used as input to a processing program or 
written as output by a processing program, the volume on which a data 
set resides or will reside must be mounted on an input/output device. 
The UNIT parameter provides the system with the information it needs to 
assign a device to the data set. 

In order for the system to assign a device, you must provide in the 
UNIT parameter: 

• The specific unit you want: code the unit address; or a general 
description of the device: code the device type or group name. 

Optionally, you can: 

• Specify how many devices you want assigned to the data set when 
more than one device is required. You can code the unit count and 
specify how many devices are required, or in certain cases, imply 
how many devices are required by coding P. 

• Request the system to assign a device to a data set and not to 
cause the volume on which the data set resides to be mounted until 
the data set is opened. 

• Request the system to assign a data set to a device other than the 
devices assigned to data sets defined in the samie job step; code 
the keyword subparameter SEP and identify the data sets from which 
you want unit separation. 

Another way to provide unit information is to request unit affinity 
with another data set by coding UNIT=AFF=ddname. The system obtains 
unit information from the named DD statement. 

Except in a few cases, the UNIT parameter is always coded on a DD 
statement that defines a data set that requires one or more devices. In 
the following cases, the system obtains the required unit information 
from other soiorces. Therefore, you need not code the UNIT parameter: 

• When the data set is cataloged. For cataloged data sets, the system 
obtains unit and volume information from the catalog. However, if 
VOLUME] =SER= serial number is coded on a DD statement that defines a 
cataloged data set, the system does not look in the catalog. In 
this case, you must code the UNIT parameter. If the VOLUME 
parameter is not coded but you request a device in the UNIT 
parameter, the request is ignored. 

• When the data set is passed from a previous job step. For passed 
data sets, the system obtains unit and volume information from an 
internal table. However, if VOLUME=SER=serial number is coded on a 
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DD Statement that defines a passed data set, the system does not 
look in the internal table. In this case, you irust code the UNIT 
parameter. If the VOLUME parameter is not coded but you request a 
device in the UNIT parameter, the request is ignored. 

• When the data set is to use the same volumes assigned to an earlier 
data set, i.e., VOLUME=REF=ref erence is coded. In this case, the 
system obtains unit and volume information from the earlier DD 
statement that specified the volume serial number or from the 
catalog. If you request a device in the UNIT parameter, the request 
is ignored. 

• When the data set is to share space or cylinders with an earlier 
data set, i.e., SUBALLOC or SPLIT is coded. In this case, the 
system obtains unit and volume information from the earlier DD 
statement that specifies the total amount of space required for all 
the data sets. If the VOLUME parameter is coded, it is ignored. If 
you request a device in the UNIT parameter, the request is ignored. 

In all of these cases, you can code the UNIT parameter when you want 
more devices assigned. 

IDENTIFYING TBE DEVICE 

You must identify to the system the specific device you want or the type 
of device you want. To identify a specific device, you must specify a 
unit address. When a unit address is coded, the system assigns you that 
unit. 

There are two ways to identify the type of device you want: specify 
a device type, which corresponds to a particular set of device features, 
or specify a group name, which identifies a group of devices that may be 
different models. When a device type is coded, the system assigns an 
available device of that type. When a group name is coded, the system 
assigns an available device that is part of that group. In all cases, 
the block size specified for the data cannot exceed the maximumi block 
size permitted for the assigned device. 

Unit Address 

To identify a device by its unit address, you specify the 3-byte address 
of the unit. The address is made up of the channel, control unit, and 
unit numbers. For example, UNIT=180 indicates you want channel 1, 
control unit 8, and unit 0. 

To request a specific bin on a specific 2321, you should code 
UNIT=address/bin, where "bin" is a number from. through 9. For 
example, UNIT=293/5 indicates you want channel 2, control unit 9, device 
3, and bin 5. If you code UNIT=293, you are requesting one of the 
available bins on that unit.. 

In MFT and MVT, you should not identify a device by its address 
unless it is absolutely necessary. Specifying a unit address limits 
unit assignmient and may result in a delay of the job if the unit is 
being used by another job. 

Device Type 

Device types correspond to particular set of features of input/output 
devices. When you code a device type, you allow the system to assign 
any available device of that device type. For example, if the device 
type you want is a 2302 Disk Storage Drive, you code UNIT=2302. The 
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system assigns an available 2302. If only cne device in the system is 
of that device type, the system assiqns that device. If there is irore 
than one device in the system of that device type, there is a certain 
degree of device independence. 

The device types that can be coded and their descriptions are listed 
below. CYou can code only those device types that were defined during 
system generation.) 



TAPE 

Device Ty p e 
2400 



2400-1 



2400-2 



2400-3 



2400-4 



Device 

2400 series Nine-Track jyjagnetic Tape Drive that can ae 
allocated to a data set written or to be written in 
800 bpi when the dual-density feature is not installed 
on the drive or in IbOO bpi when the dual-density 
feature is installed on the drive. 

2400 series Magnetic Tape Drive with Seven-Track 
Compatibility ana without Data Conversion. 

2400 series Magnetic Tape Drive with Seven-Track 
Compatibility and Data Conversion. 

2400 series Nine-Track Magnetic Tape Drive that can be 
allocated to a data set written or to be written in 
1600 bpi density. 

2400 series Nine-Track Magnetic Tape Drive havinq an 
800 and 1600 bpi density capability. 



DIRECT AC CESS 

Device Ty pe 

2301 

2302 

2303 

2311 

2314 

2321 



Devic e 

2301 Drum Storage Unit. 

2302 Disk Storage Drive. 

2303 Drum Storage Unit. 
2311 Disk Storage Drive. 
2314 Storage Facility. 

any bin mounted on a 2321 data cell drive 



UNIT RECC RD 
Device Ty pe 
1052 
1275 

1285 
1287 
1288 



Device 

1052 Printer-KeyDoard. 

1275 Optical Reader Sorter (available tnrough 
World Trade branch offices only) 

1285 Optical Reader 

1287 Optical Reader 

1288 Optical Reader 
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1403 1403 Printer or 1404 Printer (continuous forrr only) . 

I 1419 1419 Magnetic Character Reader 

1442 1442 Card Read Punch. 

1443 1443 Printer. 

I 2495 2495 Tape Cartridge Reader 

2501 2501 card Reader. 

2520 2520 Card Read Punch. 

2540 2540 Card Read Punch (read feed). 

2540-2 2540 Card Read Punch (punch feed). 

2671 2671 Paper Tape Reader. 

GRAPHIC 

Device Type Device 

1053 1053 Model 4 Printer. 

2250-1 2250 Display Unit, Model 1. 

2250-3 2250 Display Unit, Model 3. 

2260-1 2260 Model 1 Display Station (Local Attachment). 

2260-2 2260 Model 2 Display Station (Local Attachment) . 

2280 2280 Film Recorder. 

2282 2282 Film Recorder/Scanner. 

Group Name 

A group name is 1 through 8 alphameric characters and identifies a 
device or a group of devices. The group of devices can consist of 
devices of the same type or different direct access and tape device 
types. Group names are established during system generation. 

When you code a group name, you allow the system, to assign any 
available device that is included in the group. (If a group consists of 
only one device, the system assigns that device.) . For example, if 
all 2301 and 2303 Drum Storage Units are included in the group named 
DRUM and you code UNIT=DRUM, the system assigns an available 2301 or 
2303 device. 

A group may consist of m(Ore than one device type. In this case, you 
snould not code this group's group name when you are defining an 
existing data set, since the volume (s) on which the data set resides may 
require a different device than the one assigned by the system, i.e., a 
tape volume must be assigned to a tape device, not a direct access 
device. 

When the automatic volume recognition feature is included in the 
system and you specify a group name, this feature will assign devices to 
volumes already mounted, but will net request mounting of any volume 
that is not mounted. 
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UiSlIT COU.NiT 

Tne unit count subparameter indicates how many devices you want assigned 
to a data set. If you do not code this subparaireter , or code 0, the 
system assigns one device. (If you receive a passed data set or refer 
tne system to a cataloged data set or earlier ED statement for volume 
and unit information (VOLUME=KEF=ref erence) , the system assigns one 
device, even if more devices were requested in an earlier DD statement.) 
Only in one case may the system assign more than one device: when two 
DD statements in a step request use of the same volume. If either of 
these two DD statements requests any other volume (s), the system assigns 
an additional device. 

For operating efficiency, you can request multiple devices for a 
multivolume data set or for a data set that may require additional 
volumes. When each required volume is mounted on a separate device, 
time is not lost during execution of the job step while the operator 
demounts and mounts volumes. The maximum number of devices that can be 
requested per DD statement is 59. 

In the following cases, you should always code the unit count 
subparameter when the data set may be extended to a new volume: 

• If the data set resides on a permanently resident or reserved 
volume. In these two cases, the volume cannot be demounted in order 
to mount another volume. 

• If the data set is assigned space through suballocation. Code the 
unit count subparameter on the DD statemient that requests the space 
to be suballocated. 

The unit count subparameter is a positional subparameter, and it 
shares the same position as the subparameter P. If neither of these 
subparameters is coded and the DEFER or SEP subparameter follows, code a 
comma to indicate the absence of the unit count subparameter and the 
suJDparameter P. (If the DEFEK subparameter is not coded but the SEP 
parameter is coded, you miay om.it the comma.) 

PARALLEL MOUNTING 

Requesting parallel mounting has the same effect as specifying a unit 
count, i.e., more than one device is assigned to the data set. When 
parallel mounting is requested, the system counts the number of volume 
serial numbers specified en the DD statement and assigns to the data set 
as many devices as there are serial numbers. (For cataloged data sets, 
the system counts the number of volume serial numbers contained in the 
catalog.) You request parallel mounting by coding the letter P in place 
of the unit count subparameter. 

The subparameter P is a positional subparameter, and it shares the 
same position as the unit count subparameter. If neither of these 
subparameters is coded and the DEFER or SEP subparameter follows, code a 
comma to indicate the absence of the subparameter P and the unit count 
subparamieter . (If the DEFER subparameter is not coded but the SEP 
subparameter is coded, you may omit the comma.) 

DEFERRED MOUNTING 

The DEFER subparameter requests the system to assign the required units 
to a data set and to defer the mounting of the volume (s) on which the 
data set resides until the processing program, attempts to open the data 
set. The DEFER subparameter should only be coded on DD statements that 
define data sets residing on removable volumes. The DEFER subparameter 
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cannot be coded on a DD statement that defines an indexed sequential 
data set or that defines a new data set that is to be written on a 
direct access volume, because space cannot be allocated to the data set. 

If you request deferred mounting of a volume and the data set on that 
volumie is never opened by the processing program, the volumie is not 
mounted during the execution of the job step. If a later job step 
refers to that data set, the system may assign a different device to the 
data set than was originally assigned to it. 

UNIT SEPARATION 

When you make nonspecific volum.e requests for data sets defined in a job 
step, the system assigns volumes to the data sets. If the DD statemients 
that define these data sets request the scime type of device, the system 
may assign more than one data set to the sam,e device. 

If you do not want a data set to be assigned to the same device that 
is assigned to other data sets, you can request this in the SEP 
subparameter . A request for unit separation has meaning only for direct 
access devices. 

The SEP subparameter appears as the last subparameter in the UNIT 
parameter. To identify the data sets that should not be assigned the 
same device as this data set, follow SEP= with a list of up to eight 
ddnames of the DD statements that define these data sets. The listed DD 
statements must precede this statement and must be contained in the same 
job step. The list of ddnames must be enclosed in parentheses, unless 
there is only one ddname. If one of the listed DD statemients defines a 
dummy data set, the system; ignores the unit separation request for that 
data set. 

In PCP , the system ignores a unit separation request if the request 
conflicts with another unit separation request, or if sufficient devices 
are not available to satisfy the request. In jyjFT and jyiVT , the system 
issues a message to the operator if a request for unit separation cannot 
be satisfied. The operator decides if the system' should wait for 
devices to become available, if the unit separation request should be 
ignored, or if the job should be cancelled. 



Unit Affinity 

To conserve the number of devices used in a job step, you can request 
that an existing data set be assigned to the same device or devices' as 
assigned to a data set defined earlier in the job step. When two data 
sets are assigned the same device, the data sets are said to have unit 
affinity. When the data sets reside on different volumes, unit affinity 
implies deferred mounting for one of the volumies, since both volumes 
cannot be mounted on the same device at the same time. 

You request unit affinity by coding UNIT=AFF=ddnamie on a DD 
statement. The ddname is the name of an earlier DD statem.ent in the 
same job step, and the system obtains unit information from this 
statement. The data set defined on the DD statement that requests unit 
affinity is assigned the sam^e device or devices as the data set defined 
on the nam.ed DD statement. If the ddname refers to a DD statement that 
defines a dummy data set, the data set defined on the DD statement 
requesting unit affinity is assigned a dummy status. 

When unit affinity is requested for two data sets that reside on 
different 2321 volumes, the data sets are assigned the samie device but 
may be assigned different bins. 
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Examples o£ the UNIT Parameter 

1. //DDl DD DSNAME-AAG3,DISP=(,KEtP) , X 
// VOLUME=SER=13230,UiNlIT=2U00 

This DD stateirent defines a new data set and requests the systeiTi to 
assign any 2 4 00 9-Track Tape Drive to the data set. 

2. //DD2 DD DSNAME=X.Y.Z,DISP=0LD,UNIT=(,2) 

This DD stateiiient defines a cataloged data set and requests the 
system to assign two devices to the data set. The device type is 
obtained froiT; the catalog. 

3. //DD3 DD DSNAME=COLLECT,DISP=CLD, X 
// VOLUME=3EK=1095,UNIT={DISK, ,DEFEE) 

This DD stateir.ent defines an existing data set that resides on a 
direct access volume and requests the system to assign any device 
that is part of the group named DISK. Since DEFEF is coded, the 
volume is not mounted until the data set is opened. 

4. //STEPl EXEC PGM=XTRA 

//DDA DD UNIT=2311,SPACE=(102U, (150,20)) 
//DDE DD UNIT=2311,SPACE-=(1024, (100,10)) 
//DDC DD UNIT= (2311, SEP= (DDA, DEE) ) ,SPACE=( 2048, (300,30)) 

The DD statements in this joh step define tem.porary data sets. The 
DD statement named DDC requests the system to assign the data set to 
a different device than is assigned to either of the data sets 
defined on the DD statements named DDA and DD±3. 

5. //STEP2 EXEC PGM=POINT 

DSNAME=EST,DISP=lyiGD,VOLUME=SEii=^( 42569, 42570) , X 
UISiIT=(2 311,2) 

DSNAME==ERAS,DISP=OLD,Ut<]IT=2 400-2 

DSNAME=RECK , DISP=OLD , X 

VOLUME=SEiR= (406 53,13 262) , iJNIT=AFF=EDX 

The DD Statement named LDZ requests tnat the system assign the same 
unit to this data set as it assigns to the data set defined on the 
statement named DDX. Since DDX requests two devices, these two 
devices are assigned to the data set defined on DEZ. 



//DDX 


DD 


// 




//DDY 


DD 


//DDZ 


DD 


// 
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The VOLUME Parameter 



VOLUME /-( [PRIVATE] r ,RETA1N 
VOL ^ ' 



r ^,RETAlN"j r , volume sequence number"! [,volume count] | [,] 



SER=(serial number,...) 
REF=^5name 
REF=*.ddname 
REF=*.stepname.ddname 
_ REF=*.stepname.procstepname.ddname 



PRIVATE 

indicates that no output data set can be allocated to this volume 
unless the voluir.e is specifically requested, and the voliL is to 
be demounted after its last use in the jofc step, unless KETAIN is 
coded or the data set is passed. 




, RETAIN 

indicates that this voluine is not to be deirounted after its last 
use in the jofc step. 



indicates that the volurae does not need to be considered a private 
volume and the volume sequence number or volume count subparameter 
follows . 

, volume sequence number 

specifies which volume of an existing multivolume data set you want 
to begin processing with. 

indicates that you want to begin processing of an existing 
multivolume data set with the first volumie, and the volume count 
subparameter follows. 

, volume count 

specifies the maximum, number of volumes an output data set 
requires . 

specifies that either the SER or REF subparameter follows and one 
or more subparameter s precede it. 



SER= 



indicates that the serial numbers of the volumes on which trie data 
set resides or will reside follow. 



(serial number,...) 

the serial numbers of the volumes on which the data set resides or 
will reside. 

REF= 

indicates that the serial numbers of the volumes on which the data 
set resides or will reside are identified on an earlier DD 
statement in the job or in the catalog. 

dsname 

the name of a cataloged or passed data set. The system locates the 
information about the data set and assigns your data set to the 
same voliimes as are assigned to the cataloged or passed data set. 
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*''"^"^plcifies that the svstem must obtain the voluE.e serial numbers 

^^onai earlier DD staten,ent nan.ed "daname" in the sa:re 30b step. 

*.stepnarne ddname ^^.^ ^^^^ ^^^^^^ ^^^^i^^ nuntoers 

S^^a DD st:te™e:t^aLd__"ddna„e." which «as defined xn an earlror 

job step named "stepname." 

*.stepnaine procstepnarne.ddname ^^^^^^ ^^^.^^ numbers _ 

??ra^DD st^L^e^t^rared "ddna.e," which .as f ^^-^^^^^ ^f "- 
procedure step named "procstepnane" ; the Procedure .tep xs part oi 
a procedure that was called by an earlier Dob step named 
"stepnarae. " 

Rules for Coding 

1. The volume sequence number subparameter can be 1 to 4 digits. 

2. The volume count subparameter is a number from 1 through 255. 

3. If the only subparameter you are coding is PRIVZ^Tj:;, you need not 
enclose it in parentheses. 

U. If the only subparameter you are coding is SEK or REF, code 
VOLUME=SER= (serial number,...) or VOLUME=REF=reference. 

5. If the list of volume serial numbers consists of only one serial 
numper, you need not enclose the serial number in parentheses. 

6. The VOLUME, DDNAME, and SYSOUT parameters are mutually exclusive 
paraimeters; therefore, if DDNAME or SYSCUT is coded, do not code 
the VOLUME parameter. 



Providing Volume Information 

A volume can be a tape reel, a disk pack, a data cell, a drum, or part 
of an IBM 2302 Disk Storage device served by one access mechanism. The 
VOLUME parameter provides information about the volume or volumes on 
which an input data set resides or on which an output data set will 
reside. 

Before a data set can be read or written, the volumie on which the 
data set resides or will reside must be mounted. For an existing data 
set, you must identify the volume or volumes on which the data set 
resides by making a specific volume request. For a new data set, you 
can make a specific volume request or let the system select a volume for 
you by making a nonspecific volume request. 

Specific Volume Regues t 

A specific volume request informs the system of the volume's serial 
number. Any of the following implies a specific volume request: 

1. The data set is passed from an earlier step or is cataloged. 

2. VOLUME=SER=serial num.ber is coded on the DD statement. -^^ 

3. VOLUME=REF=ref erence is coded on the DD statement, referring to an 
earlier specific volume request. 
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When you make a specific voluir.e request, you can code the PRIVATE 
subparaitieter or the PRIVATE and RETAIN subparairieters in the VOLUME 
parameter. For passed data sets, you can also code the volume count 
subpar arret er. For cataloged data sets, you can also code the sequence 
number and volume count subparameters. 

Nonspecific Volume Request 

A nonspecific volume request can be made only if you are defining a new 
data set. When you make a nonspecific volume request, the system iray 
assign your data set to a volume that is already mounted or may cause a 
volume to be mounted. What the system does depends on the volume state 
of the volumes that are already mounted. The volume states that mounted 
volumes can assume and how they affect volume selection are described 
under "Volume States" at the end of this chapter. 

When you make a nonspecific volume request, you can code the PRIVATE 
subparameter, or the PRIVATE and RETAIN subparam.eters, and the volume 
count subparameter in the. VCLUME paramieter. 

THE PRIVATE SUBPARAMETER 

When you make a specific or nonspecific volume request, you can code 
PRIVATE as the first subparameter in the VOLUME parameter. The volume 
assigned is called a private volume. A private volume cannot be 
assigned to any data set for which a nonspecific volume request is made. 
In addition, a private volume is demounted after its last use in the job 
step unless RETAIN or PASS is coded or the volume is a permanently 
resident or reserved volume. (Permanently resident and reserved volumes 
are described under "Volum.e States" at the end of this chapter.) 

If PRIVATE is the only subparameter coded in the VOLUME parameter, 
you need not enclose it in parentheses. 

When PRIVATE Is Not Coded 

What occurs when PRIVATE is not coded depends on the type of volume 
request and whether a direct access or tape device is requested. 

Specific request for a direct access volume ; If PRIVATE is not coded 
and you make a specific request for a direct access volume, the volume 
assigned is called a public volume. A public volume remains mounted 
after its last use in a step so that it can be used again without the 
need to remount it. 

Nonspecific request for a direct access volume ; If PRIVATE is not coded 
and you make a nonspecific request for a direct access volume and the 
data set is temporary , the system assigns a volume called a public 
volume. If PRIVATE is not coded and you make a nonspecific request for 
a direct access voliame and the data set is nontempor ary , the system 
assigns a volume called a storage volume. Public and storage volumes 
remain mounted after their last use in a step so that they can be used 
again without the need to remount them. If it is possible that the data 
set may require more space than was requested for it, request m.ore than 
one volume in the volume count subparam.eter of the VOLUME paramieter and 
more than one device in the unit count subparameter of the UNIT 
parameter . 

Specific request f or a tape volume ; If PRIVATE is not coded and you 
make a specific request for a tape volume, the system treats it as a 
request for a private volume. (How this affects the volume is described 
in the previous topic "The PRIVATE Subparameter.") 
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Nonspecific reques t for a ta pe yo luin e: If Fi^lVATE is not coded and you 
make a nonspecific request for a tape volume and the data set is 
nontemporary , the system treats it as a request for a private volume. 
(As mentioned earlier, the system always considers certain requests to 
be specific. For tape volumes, the systein also considers the follov/inq 
to be a specific request: a status of OLD or SHR and a disposition of 
other than DELETE coded in the DISP parameter.) iriov; a request for a 
private volume affects the volume is described in the previous topic 
"The PRIVATE Subparameter." 

If PRIVATE is not coded and you make a nonspecific request for a tape 
volume and the data set is t emporary , the system: assigns a volume called 
a scratch volume. A scratch volume remains mounted after its last use 
in a step so that it can be assigned again without the need to remount 
it. If it is possible that the data set may exceed one volvime, request 
miore than one volume in the volume count subparameter of the VCLUKE 
parameter and more than one device in the unit count subparameter of the 
UNIT parameter. 

When PRIVATE is not coded, and the volume sequence numiber or volumie 
count subparameter is coded, you must code a comma to indicate the 
absence of PRIVATE. 



TiiE RETAIN SUBPARAMETER 

If you have coded PRIVATE as the first subparam.eter in the VOLUME 
parameter, you miay want to code RETAIN as the second subparameter. 
RETAIN overrides the system action of dem.ounting a private volume after 
its use in a job step. Instead, the volum.e rem.ains mounted until after 
it is used in a subsequent step or at the end of the job, whichever 
occurs first. If the data set resides on more than one volume and tne 
volumes aire mounted in sequential order, only the last volume is 
retained., 

The RETAIN subparamieter need not be coded when the data set is to be 
passed; the system automatically retains the volumes on which the data 
set resides. 

If the RETAIN subparameter is not coded and the volume sequence 
number oj: volume count subparameter follows, code a comma to indicate 
the absence of RETAIN. 



THE VOLUME SEQUENCE NUMBER SUBPARAMETER 

When you are reading or lengthening an existing multi volume data set, 
you can begin processing witn other than the first volume of the data 
set by coding a volume sequence number. The sequence number can range 
from 1 to 255. A volume sequence number is normally coded when volume 
i^erial numibers are not specified on the DD statement (i.e., you are 
retrieving a cataloged data set or VCLUMi= ( , ,seq#,REF=ref erence) is 
coded) , If both a volume sequence number and volume serial numbers are 
coded in the VOLUME parameter, you will begin processing with the volumie 
that corresponds with the volume sequence numiber. 

The volume sequence num.ber is a positional sutpareiieter and must 
follow the PRIVATE and RETAIN subparameters or tne commas that indicate 
their absence. If the volume sequence numoer subparameter is not coded 
and the volume count subparameter follows , code a comma to indicate the 
absence of a sequence number. 
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THE VOLUME COUNT SUBPARAMETEK 

The volume count subparameter tells the system the iraximum nuirber of 
volumes an output data set may require. The number can range from 1 
through 255. When you miake a nonspecific volume request and the data 
set ffiay exceed one volume, request miOre than one volume in the volume 
count subparameter and code PRIVATE or request the same numiber of 
devices as volumes. When you make a specific volume request and the 
data set may require use of more volumes than there are serial numibers, 
specify in the volume count subparameter the total nuirber of volumes 
that may be used. By requesting multiple volxames in the volume count 
subparameter, you can ensure that the data set can be written on more 
than one volume if it exceeds one volume. 

If you make a nonspecific volume request and the volume count exceeds 
the number of direct access devices requested in the UNIT parameter, you 
snould code PRIVATE, e.g., U1SIIT=(2311, U) ,VOLUME=(PRIVATE , , ,6) . When 
PRIVATE is coded and all the mounted volumes are used, the systemi 
aemounts one of the volumes and then mounts another volume in its place 
so that processing can continue. When PRIVATE is not coded and all the 
miounted volumes are used, the system does not demount any of the 
volumes; therefore, the job step abnormally terminates. For tape 
devices, the PRIVATE subparameter is unnecessary; additional volumies are 
mounted as they are required. 

Tne volume count subparameter is a positional subparamieter . If you 
omit this subparameter, you code a comma to indicate its absence only if 
PRIVATE, RETAIN, or the volume sequence number subparamieter is coded and 
the SER or REF subparameter follows . 

SUPPLYING VOLUME SERIAL NUMBERS (SER) 

To retrieve an existing data set, other than a cataloged or passed data 
set, you must supply the system with the serial numbers of the volumes 
on which the data set resides. When you are creating a data set, you 
can supply the system with the serial numbers of the volumes on which 
the data set will reside or let the system assign volumes to the data 
set. One of the ways to supply the system with serial numbers is to 
code the serial numbers on the DD statement. You can specify a maximiumi 
of 255 volume serial numbers per DD statement and a maximum of U095 
volume serial numbers per job step. 

A volume serial niamber must be 1 to 6 characters in length. If 
volume serial number is not 6 characters, it will be padded with 
trailing blanks. It can contain any alphameric and national (#,$,a) 
characters, and the hyphen. You must enclose any volume serial niomber 
that includes special characters, other than a hyphen, in apostrophes 
whenever you code that num,ber in the VOLUiME parameter. When using 
various typewriter heads or printer chains, difficulties in volume 
serial recognition may arise if you use other than alphameric 
characters. Each volume at an installation should have a different 
serial number regardless of the volume type, e.g., tape, disk; the 
volume's serial number should be posted on the outside of the volume. 

The SER subparameter appears as the last subparameter in the VOLUME 
parameter. Follow SER= with the volume serial numbers. The serial 
numbers must be enclosed in parentheses, unless there is only one serial 
number. If SER is the only subparameter you are coding, you can code 
VOLUME=SER= (serial number, ) or VOLUME=SER=serial number. 

SCRTCH should not be used as a volume serial number, because it is 
used to notify the operator to mount a non-specific volume. For Optical 
Readers, if no volume serial number is specified, VOLUME=SER=OCRINP is 
assumed. 
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REFERRING THE SYSTEM TO AN EARLIER SPECIFIC VCLUWE REQUEST (REF) 

Another way to supply the system with volume serial numbers is to refer 
the system to either a cataloged data set or a data set that is defined 
earlier in the job. When you do this, the system obtains volume 
information, including volume serial numbers, and unit information from 
the source you refer it to. 

To refer the system to a cataloged data set or to a data set passed 
earlier in the job that has not been assigned a temporary data set name, 
you code REF as the last subparameter in the VOLUiXiE param.eter. Follow 
REF= with the data set name of the cataloged or passed data set. The 
data set name you code cannot contain special characters, except for 
periods used in a qualified name. 

To refer the system to a data set defined earlier in the job that was 
not passed or was passed but assigned a temporary name, you code REF= as 
the last subparameter in the VOLUME parameter. Follow REF= with a 
backward reference to the DD statement that contains tne volume serial 
numbers. This backward reference must be one of the following: 

1. *.ddname . Use this form of backward reference when the DD 
statement you are referring to is contained in the same job step. 

2. * . stepname . ddname . Use this form of backward reference when the DD 
statement you are referring to is contained in an earlier job step. 

3. * . stepname . pr oc stepname . ddname . Use this form of backward 
reference when the DD statement you are referring to is contained 
in a cataloged procedure step that is part of a procedure called by 
an earlier job step. 

In any case, if the ddname refers to a DD statement that defines a dummiy 
data set, the DD statement requesting use of the volumes assigned to 
that data set is assigned a dummy status. 

When you refer the system to a data set that resides on more than one 
tape voliame, the system assigns only the last volume. When you refer 
the system to a data set that resides on more than one direct access 
volume, the system assigns all of the volumes. In either case, you can 
code the volume count subparameter if additional volumes may be 
required. 

If REF is the only subparam.eter you are coding, you can code 
VOLUME=REF=ref erence . 



Volume States 

Every mounted volume is assigned several attributes by the system. The 
attributes assigned to a mounted volume define the state of the volume; 
the volume state controls when a volume is demounted and controls volume 
sharing. Volume sharing is the allocation of a volume to two or more 
data sets defined in the same job step, or, in a multiprogramming 
environment, the allocation of a direct access volume to two or more 
data sets defined in different job steps that are executing 
concurrently. 

The attributes that are assigned both to a tape or direct access 
volume are the mount attribute and the use attribute. The nonsharable 
attribute can also be assigned to a direct access volumie. These 
attributes are described in the next two topics. 
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THE MOUNT AND USE ATTRIBUTES 

Every volume is assigned a mount and use attribute. The mount attribute 
controls volume demounting. The use attribute is one of the factors 
that controls allocation of mounted volumes to data sets. The mount and 
use attributes are: 



1 


iyiount 


1 


Use 


-1 
1 


L 









-^ 



I Permanently resident j Public ) 
I Reserved | Private | 
I Removable | Storage | 
I I Scratch | 
L X . J 

The following lists the miount attributes and describes how this 
attribute and a use attribute are assigned to a volume. 

1. Permanently resident volumes cannot be demounted. Only direct 
access volumes can be permanently resident. While all direct 
access volumes can be designated as permanently resident in a 
special member of SYSl.PARMLIB named PRESRES, the following volumes 
are always permanently re^sident: 

• All volumes that cannot be physically demounted, such as a 2301 
Drum Storage volume. 

• The volume from which the system is loaded (the IPL volume) . 

• The volume containing the system data sets SYSl.LINKLIB, 
SYSl.PROCLIB, and SYSl.. SYSJOBQE. 

A permanently resident volumie can be assigned the use attribute of 
public, private, or storage. The use attribute is assigned to the 
volume in the PRESRES member in SYSl.PARiy.LIB, or is public by 
default. 

2" Reserved volumes remain mounted until an UNLOAD command is issued. 
Both direct access and tape volumes can be reserved volumes. A 
volume becomes reserved as a result of a y:OUNT commamd or a PRESRES 
entry. A volume is usually designated as a reserved volume to 
avoid repeated mounting and demounting of the volume when it is to 
be used by a group of related jobs. 

A reserved direct access volume can be assigned the use attribute 
of public, private, or storage. The use attribute is assigned to 
the volume either in the PRESRES member in SYSl .PARi^dLIB or in a 
parameter of the MOUNT command, depending en how the volume becomes 
reserved. 

A reserved tape volume is always assigned the use attribute of 
private. 

3. Removable volumes are those volumes that are neither permanently 
resident nor reserved. Removable volumes are demounted either 
after their last use in a job step or when the unit on which the 
volume is mounted is reguired for another volume, which occurs 
depends on the use attribute assigned to the volume. 

A removable direct access volumie can be assigned the use attribute 
of public or private. The use attribute of public is assigned when 
the PRIVATE subparameter is not coded. The use attribute of 
private is assigned when the PRIVATE subparameter is coded. 
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A removable tap e volume can be assigned the use attribute of 
scratch or private. The use attribute of scratch is assigned when 
the PRIVATE subparameter is not coded, a nonspecific voluire request 
is made, and the data set is temporary. The use attribute of 
private is assigned when the PRIVATE subparameter is coded, a 
specific volume request is made, or the data set is nontemporary. 
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Table 2 summarizes what type of volume can be assigned when you miake 
a specific or nonspecific volunie request for a temporary or nontemporary 
data set, how these attributes are assigned, and how the volume is 
demounted. 



Table 



Combinations of Mount and Use Attributes 



T T 

I Temporary | iMontemporary 
I Data Set | Data Set 
|. X ^ 

Volume State | Type of Volume Request 



Public/ 

Permanently 

Resident^ 



i Nonspecific 
j or Specific 



Private/ 

Permanently 

Resident^ 



i Specif ic 
I 



-+ 



Storage/ 

Permanently 

Resident^ 



j Nonspecific 
I or Specific 



Public/ 
Reserved^ 



■+ 

I Nonspecific 
I or Specific 



Private/ [Specific 
Reserved (Tapej 
and direct | 
access) 



Storage/ 
Reserved^ 



i Nonspecific 
I or Specific 



Public/ 
Removable^ 



I Nonspecific 
I or Specific 



Private/ 
Removable | 
(Tape and | 
direct access) j 



i Specific 



Scratch (Tape j Nonspecific 
only) I or Specific 



Specific 



Specific 



Nonspecific 
or Specific 



Specific 



Specific 



Nonspecific 
or Specific 



Specific 



Specific 



Nonspecific 
or Specific 



How Assigned 



PRESRES Entry or 
by default 



PRESRES Entry 



PRESRES Entry 



PRESRES Entry or 
MOUNT command 



PRESRES Entry or 
MOUNT command 
(Only MOUNT 
command for tape . ) 



-+- 



PRESRES Entry or 
MOUNT command 



VOLUME=PRIVATE is 
not coded on the 
DD statement 



VOLUME=PRIVATE is 
coded on the DD 
statemient 
(Specific request 
or a nontemiporary 
data set for tape 
also causes this 
assignment. ) 



Any tape data set 
(Scratch volune 
becomes private 
if VOLUME=PRIVATE 
is coded, specific 
request is made, 
or data set is 
nontemporary . ) 



How 
Demounted 



Always 
mounted 



Always 
mounted 



Always 
mounted 



UNLOAD 
command 



UNLOAD 
comimand 



UNLOAD 
command 



When unit 
is required 
by another 
volume. 



-+- 



After its 
use, unless 
RETAIN or 
PASS is 
coded, in 
which case, 
volume 
demounted 
at job 
termination 



When unit 
is required 
by another 
volume. 




j ^Direct access volumes only. 

L 
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NONSHARABLE ATTRIBUTE 

The nonsharable attribute is assigned by the systeir, to direct access 
volumes that inay require demounting during execution of the step that 
requested the volume. When a volume is assigned the nonsharable 
attriiDUte, the volume cannot be assigned to a data set defined in the 
same step for which a nonspecific request is made or to any data set 
defined in another step that is being executed concurrently. 

The nonsharable attribute is never assigned to a permanently resident 
or reserved volume or to a volume that was mounted to satisfy a 
nonspecific request for a public voliorae. Except for these cases just 
described, the nonsharable attribute is always assigned to a volume when 
the following occurs : 

1. You make a specific volumie request and request more volumes than 
devices. 

2. You request unit affinity with an earlier data set defined in the 
job step. (The volumes on which the data sets reside must be on 
different volumes,) 

3. You request deferred mounting of the volume on which the data set 
resides. 

4. You make a nonspecific request for a private volume. 

SATISFYING SPECIFIC VOLUME REQUESTS 

In the following cases the system can satisfy a request for a specific 
volume that is already mounted: 

1. The volume is permanently resident or reserved. The use attribute 
of the volume does not affect assignment of the volume and the use 
attribute is not changed. 

2. The direct access volumie is a removable volume that has not been 
assigned the nonsharable attribute and is being used by a 
concurrently executing step. (If your request would make the 
volume nonsharable, the system waits to assign you that volume 
until all other job steps using the volume have terminated.) The 
volume remains private if its use attribute is private. The volume 
becomes private if the use attribute is public and the request is 
for a private volume. The volume remains public if its use 
attribute is public and the request is for a public volume. 

3. The direct access volume is a removable public volume and is not in 
use. The use attribute (private or public) assigned to the volume 
when it is allocated is determined by the presence or absence of 
the PRIVATE subparameter . 

4. The tape volume is a scratch volume and is not in use. The use 
attribute of private is assigned to the volume. 

SATISFYING NONSPECIFIC VOLUME REQUESTS 

There are four types of nonspecific volumie requests that can be made: 

1- You can request a private volume for a temiporary data set. 

2.. You can request a private volume for a nontemporary data set. 

3, You can request a public volume for a temiporary data set. 

U.. You can request a storage volume for a nontemporary data set. 

How the system satisfies these different types of requests are described 
below. Since the system satisfied the first two types of requests in 
the same way, these two requests are described together. 
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1. when you rrake a nonspecific volume request for a private direct 
access or tape voluipe, the system assigns a volume that is mounted 
but not in use or requests the operator to mount a volume. The 
operator should mount a volume whose space is unused. This allows 
you to have control over all space on the volume. Once mounted, 
the volume is assigned the use attribute of private. 

2. When you make a nonspecific volumie request for a public direct 
access volume that is to contain a temporary data set, the system 
assigns a public or storage volume that is already mounted, or 
requests the operator to mount a removable volume. If a mounted 
volume is selected, its use attribute is not affected. If a 
removable volume is mounted, it is assigned the use attribute of 
public. 

When you make a nonspecific volume request for a public tape volume 
that is to contain a temporary data set, the system assigns a 
scratch volume that is already mounted, or it requests the operator 
to mount a tape volume. Once mounted, the volume is assigned the 
use attribute of scratch. 

3. When you make a nonspecific volume request for a public direct 
access volume that is to contain a nontemporary data set, the 
system assigns a storage volume if one is mounted. Otherwise, the 
request is treated as a nonspecific volume request for a private 
volume . 

When you make a nonspecific volume request for a public ta pe volume 
that is to contain a nontemporary data set, the request is treated 
as a nonspecific volume request for a private volume. 

Examples of the VOLUME Parameter 

1. //DDl DD DSNAME=STEP,UNIT=2311,DISP=OLD, X 
// VOLUME=(PRIVATE, ,,SER=5U8863) 

This DD Statement defines an existing data set and informs the 
system that the data set resides on the volume whose serial number 
is 548863. Since PRIVATE is coded in the VOLUME parameter, the 
system will not assign the volume to any data set for which a 
nonspecific volume request is made and will cause the volume to oe 
demounted after its use in the job step. 

2. //DDB DD DSNA]yiE=CCMM,DISP= (NEW, KEEP) ,SPACE=(CYL, (30,2)) , X 
// VOLUiyiE=( PRIVATE,,, 2) ,IINIT=2311 

The DD statement named DDB defines a new data set for which the 
system is to assign a volume. Since only one device is requested 
(UNIT=2311) and the volume count is 2, PRIVATE is coded to ensure 
that the additional volume can be mounted if required. 

3. //DD2 DD DSNAME=QUET,DISP=(MOD,KEEP) ,UNIT=(2400,2) , X 
// VOLUME=(,,, a, SER=( 96341, 96342)) 

This DD statement defines an existing data set, which resides on the 
volumes whose serial numbers are 96341 and 96.342, and requests that 
a total of 4 volumes be used to process the data set if required. 

4. //DD3 DD DSNAME=6OUT,DISP=N£W,UNIT=2400 

This DD statement defines a temporary data set and, by omission of 
the VOLUME parameter, requests the system to assign a suitable 
volume to the data set. 
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Section V: The Command Statement 



CoiTiinands are issued -to communicate with and control the system. All 
commands may be issued to the system via the operator's console; sone 
commands may be also issued via a coirmand statement in the input stream. 
In most cases, the operator issues the command. If you include a 
command statement as part of your job control statements, the command, 
except SET and START in PCP, is usually executed as soon as it is read. 
(Disposition of commands read from an input stream is specified as a 
PARM parameter field in the cataloged procedure for the input reader.) 
Since a command is usually executed as scon as it is read, in MFT and 
MVT it is not likely that the command will be synchronized with the 
execution of the job step to which it pertains. Therefore, you should 
tell the operator which commands you want issued and when they should ce 
issued, and let him issue them. 

A command statement may appear imiriediately before a JOB statement, an 
EXEC statement, a null statement, or another comm.and statement. 



The Command Statement Format 



Comman( 







// command operand coff,ments 

The command statement consists of the characters // in columns 1 and 2, 
and three fields — the operation (command) , operand, and comments 
fields. 



Rules for Coding 



Code the command statement in the following oraer 
1. Code // in columns 1 and 2. 



I-IO 11-20 21-30. 31-40 41-50 51-60 ^ 61-70 ^ 71-80 , 

lT2l3|4|5l6l7|8|9|0lll2|3|4|5l6l7lel9l0|l|2|3|4l5|6l7|8|9|0|l|2|3|4|5|6|7|8l9l0lll2l3l4l5l6|7|8l9|0ll|213|4|5|6i7rer9r6trr2^^^^^^^ 



I/.. 



I I 



2. Follow // with one or more clanks. 

3. Code the comm^and. 



1-10 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 


||2|3|4|516|7|8|9|0 


||2|3|4|5|6|7|8|9|0 


II2I3I4I5I6I7I8I9I0 


I|2l3|4|5l6|7|8l9i0 


II2I314I5I6I7I8I9I0 


Il2l3|4|5l6|y|8l9l0 


I|2l3l4|5|6|7i8|9|0 


I|2l3l4l5|6|7|el9l0 


//, ,2,2i^iO,MY| , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 . , , , 1 , , ,, , 1 , ., , , 1 , , . , 1 ., , . . 1 , , , , 1 . , , , 



4. Follow the command with one or more ialanks. 
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5. Code any required operands followinq the blank or blanks. Separate 
each operand with a coirma. 



I-IO ll-EO 


21-30 


31-40"' 


41-50 


SI -60 


61-70 


7l'-80 


Il2l3l4l5l6|7|8l9l0 ll2lSl4l5l6ltl8l9lO 


1 L2l3l4l5L6i7M?l0, 


II2I3KI6I617I8I9I0 


I2l3l4l5l6l7l8l9l0l|2|3|415|6|718|9|.0 


l|2|3|4|5|6|7|819|0 


II213I4I5I6I7I8I9I0 


/,/, Mi^Mri?r,oMm£:^.,. 


L2:^-L^.^ 


^-— 1— -4 


.,,,!,,,. 




. , , , 1 , . , , 


,,.,,,.,. 



6. follow the operands with one or more blanks. 

7. Code any comnients following the blank or blanks. 



; 2T3[4f5l6l7|8|9|0 



11-29 
•ll2l3l 4T5l6l7l8l 9r0 



21-30 ' '3T-40 1 "" 41-50 I 51-60 I .61"'^° _— J- 71-80 

T2T3"[4r5T6T7r8T9[ot7T2 l3T4l5T 6!7l8l9lo|ll2l3|4;5l6l7l8l9lQ|ll2l3|4|5|6|7|8 |9|OL 



//, M3.PiA.i\ :r,oM\M£,s,,ir A,. jAj^.x^m \R£m^&:i:£Ji4C^K(m/ii, &£\ X.^^m' 



The corrirand statement cannot be continued, 



Commands That Can Be Entered Through the Input Stream 

The commands that can be entered through the input stream in PCP, MFT, 
or MVT are listed below, with a brief explanation of what each command 
requests the system to do. Most command statements consist of an 
operation (command) field and an operand field, which includes options 
associated with the command. The operand field is not described here; a 
complete discussion of the commands and operands is presented in the 
Operator's Guide publication. 

PCP 

In PCP, the following coirmands can be entered through the input stream. 

DISPLAY ; The DISPLAY command causes a console display of certain system 
status information. 

MOUNT: The MOUNT command tells the system to assign a device so a 
particular volume can be miounted on it. This device can then be 
assigned by the system to any job step that requires that volume. 

SET ; The SET command is used to establish the values of certain 
variables, such as the time of day and the date. 

START ; The START command tells the system to start either an input 
reader or an output writer. 

STOP ; The STOP command tells the system to stop the console display 
effected by the DISPLAY command, or to stop an output writer. 

UNLOAD ; The UNLOAD command tells the system to remove the volume 
previously mounted after a MOUNT command was issued. 

VARY : The VARY command tells the system to place an I/O device into an 
online or offline status. 
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MFT 

In MFT, the following commands can be entered through the input stream - 

CANCEL: The CANCEL command tells the system to immediately terminate 
the scheduling or execution of a job, to cancel a job on the queue, or 
to stop the writing of an output data set currently being processed by 
an output writer. 

DISPLAY ; The DISPLAY comjmand causes a console display of certain system 
status information. 

HOLD ; The HOLD command causes the systemi to temporarily prevent one job 
or all jobs from being selected for processing. 

LOG ; The LOG command is used to enter information into the system log. 

MODIFY ; The MODIFY command tells the system to change the 
characteristics of a functioning output writer. 

MOUNT: The MOUNT command tells the system to assign a device so a 
particular volume can be mounted on it. This device can then be 
assigned by the system to any job step that requires that volume. 

RELEASE: The RELEASE command tells the system to resume job selection, 
which had been suspended by the HOLD command or TYPRUN=HOLD on the JOB 
statement. 

REPLY : The REPLY command is used to reply to messages from, the system- 
or from a processing program that requests information. 

RESET : The RESET command tells the system to change the class or 
priority, or both, of a job in an input, hold, or system output queue. 

SET: The SET command is used to establish the values of certain 
variables, such as the time of day and the date. 

START : The SiTART command tells the system to start a particular system; 
process, e.g., an input reader, graphic job processor, initiator, etc. 

STOP: The STOP command tells the system to stop a systemi process that 
had been previously started by a START command, or to stop the console 
display effected by the DISPLAY command. 

SWAP : The SWAP command allows Dynamic Device Reconfiguration of two 
volumes . 

UNLOAD : The UNLOAD command tells the system to remiove the volume 
previously mounted in response to a MOUNT command. 

VARY : The VARY command tells the system to place an I/O device or path 
into an online or offline status. 

WRITELOG: The WRITELOG command tells the system to have the system 
output writer write out the contents of the system log. 

MVT 

In MVT, the following commands can be entered through the input stream. 

CANCEL ; The CANCEL command tells the system, to immediately terminate 
the scheduling or execution of a job, to cancel a job on the queue, or 
to stop the writing of an output data set currently being processed by 
an output writer. 
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DISPLAY : The DISPLAY comiriand causes a console display of certain system 
status information. 

HOLD ; The HOLD command causes the systeir to temporarily prevent one job 
or all jobs from being selected for processing. 

LOG ; The LOG command is used to enter information into the system log. 

moiFY: The MODIFY command tells the system, to change the 
characteristics of a functioning initiator or output writer. 

MOUNT ; The MOUNT command tells the system to assign a device so a 
particular volume can be mounted on it. This device can then he 
assigned by the systemi to any job step that requires that volume. 

RELEASE ; The RELEASE command tells the system to resume job selection, 
which had been suspended by the HOLD command or TYPRUN=^EOLD on the JOB 
statement . 

REPLY: The REPLY command is used to reply to miessages from the system 
or from a processing programi that requests information. 

RESET : The RESET command tells the system to change the class or 
priority, or both, of a job in an input, hold, or system output queue. 

SET : The SET command is used to establish the values of certain 
variables, such as the time of day and the date. 

START : The START command tells the system to start a particular system 
process, e.g., an input reader, graphic job processor, initiator, etc. 

STOP : The STOP command tells the system to stop a system process that 
had been previously started by a START command or to stop the console 
display effected by the DISPLAY command. 

SWAP: The SVJAP command allows Dynamic Device Reconfiguration of two 
volumes. 

UNLOAD: The UNLOAD command tells the system to remove the volume 
previously m.ounted in response to a MOUNT command. 

VARY : The VARY command tells the system to place an I/O device or path 
into an online or offline status. In a Model 65 multiprocessing system 
(M65MP) , this command is used to place I/O devices, paths, CPU, channel, 
and storage units in online or offline status. 

WRITELOG: The WRITELOG command tells the system to have the system 
output writer write out the contents of the system log. 



Example of the Command Statement 

1. // START INIT,,,AB START AN INITIATOR FOR N:FT 

This command tells the system to start an initiator. The characters 
A and E indicate that the initiator is to select for execution only 
jobs of job classes A and B. 
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Section VI: The Comment Statement 



The comirient statement can be used to contain information that may be 
helpful to yourself or another person that may be running your job or 
reviewing your output listing. 

The comment statement may appear anywhere except before the JOB 
statement. A comment statement cannot be continued using continuation 
conventions; however, it can be followed by one or more comment 
statements . 



The Comment Statement Format 



(■ 



//♦comments 

The comment statement consists of the characters //* in columns 1, 2, 
and 3, and the comments field. 



Rules for Coding 

Code the comment statement in the following order; 
1. Code //* in columns 1, 2, and 3. 




I-IO 11-20 21-30 31-40 .^.'"50 ^'"^O. 6l-70_ 71-80 J 

|2|3 |4|5|6|7|8|9|0| I |2|3Hl5|6|7|B|9|ol I |2|3|4|5|6|7|8| 9lori |2|3|4|5|6|7|8|9|oi I |2|3|4|5|6|7|8|9|o| I |2 |3|4|5 |6|7|e|9|o| I TzTSpIsMTjelglgklgJlMSjeiTlglgjOl 



IM 



iZj 1_J i 1 1 I L-J I 1 L-J I L, 



I 



-L^--4— ■ ' 1- 



2. Code the comments in columns 4 through 8 



l|2|3|4|5|6|7|8|9|0|l|2l3|4|5l6l7l8l9l0|l|2|3|4|5|6|7|8|9|0|l|2l3|4|5|6|7l8|9|0|l|2l3|4l5|6T7|8l9l0lH2l3|4|5l6r7l8l9]0ri|2|3|4|5|6|7|a|9^ 



3. If all of the comments cannot be included on this comment 
statement, follow it with another comment statement. 



OUTPUT LISTINGS 

In the MSGLEVEL parameter, you can request an output listing of all the 
control statements processed in your job. If you do, you can identity 
comment statements by the appearance of *** in columns 1, 2, and 3. 



Example of the Coninient Statement 

1. //*THE COMMENT STATEMENT CANNOT BE CONTINUED, 

//*BUT IF YOU HAVE A LOT TO SAY, YOU CAN FOLLOW A 
//♦COMMENT STATEMENT WITH ONE OR MORii CCMMiiNT 
//♦STATEMENTS. 
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Section VII: The Delimiter Statement 



When you submit data through an input streair, you must indicate to the 
system the beginning of the data and the end of the data . The beginning 
of the data is indicated by a DD * or DD DATA statement. In PCP, the 
end of the data is indicated by a delimiter statement. In MFT and MVT, 
the delimiter statement is not required if the data is preceded with a 
DD * statement. 



The Delimiter Statement Format 



(' 



/* comments 

The delimiter statement consists of the characters /* in columns 1 and 2 
and the comments field. 



Rules for Coding 



Code the delimiter statement in the following order: 
1. Code /* in columns 1 and 2. 



I-IO 


11-20 1 


21-30 


31-40 


41-50 


51-60 61-70 


71-80 


1 121314151617181910 


II2I3I4I5I6I7I8I9I0 


I|2l3|4|9iei7|81910 


Il2l3|4l5l6l7l8l9l0 


II2I3I418I617I8I9I0 


I|2l3l4isi6l7l8l9l0il2l3|4i5l6|7|8|9|b 


Il2l3l4i5l6l7i6l9l0 


l*^.s i,J...,i,...,i 1 1,1,1 I, 1 ^ i,i.„i,| * ,,,,.„,,,. 1,1,. , 1, 1 ,| 1 ).„..„, i,„l„„i, J,., i,|,,i„,, v„.,,l r„. ,,,. ,|, .„,. ,i„i 1,1 ..,,.. |, ,.,..,, i..jj,,. ,.,.,,., |, ,,.,„. r„l,.. .,1 




2. Follow /* with one or more blanks. 

3. Code any desired comments. 



I-IO 

I|2|3|4|S|6|7|8|9|0 



11-20 

I|2|3|4|5|6|7l8l9lg 



l|2l3|4l8|6l7l8l9|0|l|gT3T4|5l6|7|el9l0!l |2l3|4|S|6|7 r8l9l0|l|2|3l4I S|6|7|e|9|0|l|2|3l4|5|6|7|e|9|0| l|2|3|4l^ 



U. The comments cannot be continued. 



Example of the Delimiter Statement 

1. //JOB54 JOB, 'C BROWN •,MSGLEVEL={ 2,0) 
//STEPA EXEC PGM=SEJ^S 
//DDl DD * 



data 



/* END OF DATA FOR THIS STEP 
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Section VIII: The Null Statement 



The null statement can be placed at the end of a job's control 
statements and data or at the end of all the statements in an input 
stream. The null statement tells the system that the job just read 
should be placed on the queue of jobs ready for processing. If there 
are any control statements or data between a null statement and the next 
JOB statement, these are flushed by the system. 

If you do not follow your job's control statements and data with a 
null statement, the system places your job on the queue when it 
encounters another JOB statement in the input stream. If your job is 
the last job in the input stream and a null statement does not follow 
it, the system recognizes that this is the last job in the input stream 
and it places your job on the queue. 



The Null Statement Format 



(^ 



The null statement consists only of the characters // in coliamns 1 and 
2. The remainder of the statement must be blank. 



Example of the Null Statement 



//MYJB 


JOB 


, ' C BROWN • , MSGLEVEL= (1,1) 


//STEPl 


EXEC 


PROC=FIELD 


//STEP 2 


EXEC 


PGM=XTRA 


//DDl 


DD 


UNIT=24 00 


//DD2 


DD 


* 




data 



/* 
// 
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Section IX: The PEND Statement 



The PEND statement is used to mark the end of an in-stream procedure. 
The name field of the PEND statement can contain a name. If comments 
are to be used, a blank must separate the operation field from the 
comment field. The PEND statement may not be continued. 



The PEND Statement Format 



f 



//name PEND comm.ents 

The PEND statement consists of the characters // in column 1 and 2 and 
four fields — the name field, the operation (FEND) field, and the 
comments field. 



Rules for Coding 

Code the PEND statement in the following order: 
1. Code // in columns 1 and 2. 



10 i 11-20 ! 21-30 31-40 



"2 1 3 14 ! 5 1 6 [7 Is {9 i oTlTz] 3 i4]5 [6 [7 \8\9\6\ ! ^[g ; 314 [ 5 16 ; 7 j 8]9l 1 Fj 2 1 3 p) ■s MtTs |9 |0l' ['[2 j 3 j 4T5]6T7 ' S] 9loT l~[2T3T4 1 S]6\T^^ | 



41-50 I 51-BO 



l2]li2JlMMl9rPltJIl3l4l5iei7lef9[c 



2. Follow // with a 1 - to 8-character name or one or more blanks. 



i "" I- 10 I 11-20 " ' ~| "" -'gjT^Q— J "~^ 31-40 " FT'' 41-50 '3 XT 51-60 _ " T .^' ""'' P 71-80 i 

I r!2f 3T4r5|"6T7i8|9|o! I |2|3l4i5i6|7|8[9]0|rr2l5 R'|5 r6]7l8 |9|6{T]2 l3l4r5 l 6]7T^ I y2 [3]4r5!6T 7| 8 T9[0! I |2|3|4|5i6|7|8|9|0|jlg]3El5l6l7iOMo! 



3. If a name is coded. 

Follow the name with one or more blanks. 

4. Code PEND. 



I- 10 I ' 11-20" '~]_ J]'- 30" "" "1_ ""\ JiT-- 40 _ ^ T" 41 -so"" 'J ' "51-60" 7X' " " "61-70 y X JI-80_ 1 

I ?2l 3J4!5l6l7] ¥| 9!0lTl2:3 |4|5T6l7!8 | 9T 0| n2i3i4: 5i6i/'8i9lo| lT2l3!4[5T6[7 Te]9!0 ['i^^^^ ! |2[3]4l5f6|7nWs"iO"P"i 2|3l'^!S '!6|7[8[9l O|'i l2 !3|4isT6|7iSl9iO^ 

//£Ml)\P,KCC f£ ML I , , . , I , , , , I , , , , I , . , , I , , , , I , , , , I . , : , ! , , , , I , , , , I , , , , I , , , ..|.x._,_.j ..... J 

5. Follow PEND with one 02: more blanks. 

6, Code any desired comments following the blank or blanks. 



muHmnzniiio 



2!-30" \ j_ ""'31-40 „l _ . 4T-56 _ I 5i-60 1 6^-70 " 1 ""_ 71-80 " i 

T"[2T3r4T5"[S"|"7[8T9r6"l I T2l3!"4 jS 1 6|7T8|"9lo[TT2T3T4T5T6 j 7 ; 8!9ToTlT2 i" 3T4r 5 T6r7T8 T9ToTn2T3l 4 j SlsfrTslgTotl Tg j 3 [4 [5T6]"7"3"'9 iO I 



n |2l3l4i5]6 |7|8|9|0 

A PEND statement cannot be continued. 
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Examples o£ the PEND Statement 

1.//PR0CEND1 PEND THIS STATEMENT IS REQUIRED FOR INSTREAM 

This PEND statement contains a comment. 

2.// PEND 

A PEND statement can contain only the coded operation field preceded by 
// and one or more blanks and followed by blanks. 
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Section X: The PROG Statement 



The PKOC statement is the fi 
procedure. Optionally, the 
statement in a cataloged pro 
a cataloged procedure, it is 
parameters in the procedure, 
statement is used to mark th 
to assign default values to 
default value appearing on a 
assigning a value to the sam 
that calls the procedure. 



rst control statement in an in-stream 

PROC statement can also be the first control 

cedure. If a PROC statement is included in 

used to assign default values for symbolic 
In an in-stream procedure, the PROC 
e beginning of the procedure and can be used 
symbolic parameter in the procedure. A 

PROC statement can be overridden by 
e symbolic paramieter on the EXtC statement 



The PROC Statement Format 



//nam.e PROC operands comments 



The PROC statement consists of the characters // in columns 1 and 2 and 
four fields -- the name field, the operation (PROC) field, the operand 
field, and the comments field. 



Rules for Coding 

code the PROC statement in the following order; 
1. code // in columns 1 and 2. 



I-IO 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 


I|2|3l4|5|6|7|8l9|0 


I|2l3|4|5l6l7|8l9l0 


I|2|3l4l5l6|7|8|9|0 


I|2|3|415|6|7|81910 


Ii2l3l4|5l6|7l8l9|0 


I12|314|5|6|718|9|0 


Il2|3|4|5l6l7|8|9|0 


I|2|3|4|5l6|7|8l9l0 


//> I 1 1 1 > < :.| 1 : .1 < 1 . . . • 1 I. > i < 1 > .r.> I [.., i . i 1 < r. i . | > . . . K >. , , | i. ,....< i . 1 . . . . 1 . .. < . 1. . . i . 1 i ... , . .1 ,,. r . 



2. Follow // with a 1- to 8-character name or one or more blanks. 
A name is required for in-stream procedures. 



I-IO 


11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 


;I|213|4|5|6|7|8|9|0 


I|2|3|4|5|6|7|8i9|0 


I|2|3|4|516|7|8|910 


I|2|3|4|5|6|7|8I9|0 


I|2l3|4!5l6|7l8l9l0 


I|2|3|4|5|6|7|8|910 


I|2l3l4|5l6l7l8|9|0 


I|2l3|4|5l6l7l8l9l0 


\L/^XP\AAh 1 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 , , , , 1 . , , , 1 , , , , 



3. If a name is coded, follow the name with one or more blanks. 

4. Code PROC. 




m 



I-IO 11-20 


21-30 


31-40 


41-50 


51-60 


61-70 


71-80 


1 |2|3|4|5|6|7|8|910 1 |2|3|4|5|6|7|8l9l0 


|I2I3I4|5[6|7|8|9|0 


|I2I3|415I6|7I8|910 


I|213|4L5|6I7I8|9J0 


II2I3I4I5I61718I9I0 


I12|31415|6|7|8|9|0 


II2I3I4I5I6I7I8I9I0 


UeKfMfi. ,?^,OiC , 1 1 , , r 1 I < ,. 1 < 1 < . < < n , < . 1 < . .< < 1 1 1 1 . 1 1 < , . 1 . . . 1 , , , , 1 , , , , 



5. Follow PROC with one or more blanks. 
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Code the syinbolic parameters and their default values following the 
blank or blanks. Separate each syiribolic parameter and its default 
value with a comma. In a cataloged procedure, this field is not 
optional. In an in-stream procedure, this field is optional; if no 
operands are included, comments may not be coded. 



"i-IO 1 ir-"20" r 2l-30" i 31-40 \'_ y'^]-50 """Y sV-eO T" 61-70 "^ _ 

[2 IM^g L6]7l8 [?JOlll2l|l4] 5 [6M8l?]0^^^ 



M3|4l5|6m8|9Lq 



7. Follow the operands with one or more blanks. 

8. Code any desired comments following the blank or blanks. 



I-IO I 11-20 I 21-30 31-40 I 41-50 i 51-60 1 61-70 _^^ 

T2T3l4|"5|6|7l8] 9lOpT2|3'|4[5T6l7l6T9lplL[2[a4l5l6,l7Sl9]0 



MMSMMIl 



/J.li?JLMA/l,,_i^0i2._MNj^^|g./,fc./A,A/^^^ X , I 



9. The PROC statement can be continued onto another statement. 



I-IO 11-20 1 21 -3b r 31-40 


41-50 


51-60 


61-70 


71-80 


lT2r3T4[5l6[7T8l9|6fltzi3|4|5l6l7l8|9|0 1 r2l3l4[5|6|7|8i9lo| 1 r2l3l4|5|6l7|8l9T0 


ll2[3l4l5|6T7T8l9l0 


n2T3T4T5T6r7T8T9Tb 


112|3|4|5|6|7|8|9|0 


I|2|3|4|5l6l7|8|9|0 


(/. j:M^,syM::ii^DAXCL^?ARA\/>iKLE£iS,MMp£^, Ji/Vfi. Ll\B.^.M , , , , 


■- '■- L'--— - 





If PROC Statement is to be included in a cataloged procedure, it must 
appear as the first control statement. For an in-stream procedure, the 
PROC statement is required; it must appear as the first control 
statement of the in-stream procedure. 



Assigning a Value on a PROC Statement to a Symbolic Parameter 

To assign a value on a PROC statement to a symibolic parameter, code: 

symbolic parameter=value 

Omit the ampersand that precedes the symbolic parameter in the 
procedure;. 

You C£in also nullify a symbolic parameter on the PROC statement. 
Code: 

symbolic parameter= 

Omit the ampersand that precedes the symbolic parameter and do not 
follow the equal sign with a value. 

There are some things you should keep in mind as you assign values to 
symbolic parameters: 

1. The value you assign can be any length, but it cannot be continued 
onto another statement. 

2. If the value contains special characters, enclose the value in 
apostrophes (the enclosing apostrophes are not considered part of 
the value). If the special characters include apostrophes, each 
must be shown as two consecutive apostrophes. 
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3. If you assign inore than one value to a symbolic parameter on the 
PROC statement, the first value encountered is assigned. 

4. If the symbolic paraireter is concatenated with some other 
information (e.g., &JOBNO. 321) , this information and the value you 
assign to the symbolic paramieter cannot exceed a combined total of 
120 characters. 



Example of the PROC Statement 

1. //DEF PROC STATUS=OLD,LIBRARY=SYSLIB,NUKBER=777777 
//NOTIFY EXEC PGM=ACCUiyi 

//DDl DD DSNAME=]y3GMT,DISP=(gSIATUS,KEEP) ,UNIT=2U00, X 

// V0LUM1E=SER=888888 

//DD2 DD DSNAME=SLIBRARY,DISP=(OID,KEEP) ,UNIT=2311, X 

// VOLUMF=SER=&NUl«BER 

Three symbolic parameters are defined in this cataloged procedure: 
&STATUS, &LIBRARY, and 6NUMBER. Values are assigned to the symbolic 
parameters on the PROC statement. These values are used when the 
procedure is called and values are not assigned to the symbolic 
parameters by the programmer. 

2 . //CARDS PROC 

This PROC statement can be used to mark the beginning of an 
in- stream procedure named CARDS. 
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Section XI: Appendixes 



Appendixe 
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I Appendix A: Cataloged and In-stream Procedures 



A cataloged procedure is a set of job control statements that has been 
assigned a name and placed in a partitioned data set known as the 
procedure library. (The IBM-supplied procedure library is named 
SYSl.PROCLIB; at your installation, there iiiay be additional procedure 
libraries, which would have different names.) An in-stream procedure is 
a set of job control statemients in the form of cards that have been 
placed in the input stream of a card reader. An in-stream procedure can 
be executed any number of times during the job in which it appears. 
Both cataloged and in-stream procedures can consist of one or more 
steps; each step is called a procedure step. Each procedure step 
consists of an EXEC statement and DD statements . The tXEC statement 
identifies to the system what programi is to be executed. The BD 
statements define the data sets to be used by the prooram. 

You can use a cataloged procedure by coding the procedure name on an 

I EXEC statement. You can use an in-stream procedure by coding the 
procedure name that is on the PROC statement on an EXEC statement. with 
both cataloged and in-stream^ procedures, you can follow this EXEC 
statement with DB statements that modify the procedure for the duration 
of the job step. 

Appendix A consists of two chapters. The first chapter "Using 
I Cataloged and In-stream Procedures" describes how to call a procedure, 
how to assign values to symibolic parameters , how to override parameters 
on the EXEC and DD statement, and how to add DD statements to a 

(procedure. The second chapter "Writing Procedures: Cataloged and 
In-stream" describes the raakcjup of a procedure, how to use symbolic 
parameters, how to place a set of job control statements in the 
procedure library, and how to modify a procedure. 
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Using Cataloged and In-stream Procedures 



How to Call a Cataloged Procedure 

To use a cataloged procedure, submit a JOB stateir.ent followed by an JtXEC 
statement. On the EXEC statement you identify the cataloged procedure 
in one of two ways: / 

1. Code, as the first operand, the name assigned to the procedure; or 

2. code PROC= followed by the name assigned to the procedure as the 
first operand. 

When you call a procedure, the system finds the control statements in 
the procedure library and then executes the programs identified on the 
EXEC statements in the procedure. 

Besides identifying the procedure on the EXEC statement, you can 
assign values to symbolic parameters and override parameters that are 
coded on the EXEC statements contained in the procedure. You follow the 
EXEC statement with DD statements when you want to override DD 
statements in the procedure or add DD statements to the procedure. 

When a cataloged procedure is written as part of the system output 
listing (i.e., MSGLEVEL=(1, 0) , MSGLEVEL= ( 1 , 1) , or MSGLEVEL^l is coded on 
the JOB statement), the procedure statements can be easily identified. 
An XX appears in columns 1 and 2 of a procedure statement that you did 
not override; X/ appears in columns 1 and 2 of a procedure statement 
that you did override; XX* appears in columns 1 through 3 of a procedure 
statement, other than a comment statemient, that the system considered to 
contain only comments; and *** appears in columns 1 through 3 of a 
comment statement. In addition, if the procedure contains symbolic 
parameters, the output listing will show the symbolic paramieters and the 
values assigned to them. 



How to Call an In-stream Procedure 

To use an in-stream procedure, include the procedure, beginning with a 
PROC statement and ending with a PEND statement, with the job control 
language for your job. The in-stream procedure can appear immediately 
following the JOB statement, the JOBLIB DD statement, or the SYSCHK DD 
statement. The in-stream procedure cannot appear before the JOB 
statement or after the EXEC statement that calls it. An in-streami 
procedure can appear after a SYSIN DD * statement; however, this is not 
advisable because the SYSIN DD * statement causes the input reader to 
obtain direct access space for a system input data set. 

To call the procedure, you identify the in-streami procedure on an 
EXEC statement in one of two ways; 

1. Code, as the first operand, the name on the PROC statement of the 
procedure; or 

2. Code PROC= followed by the name on the PROC statement of the 
procedure . 

When you call an in-stream procedure, the system finds the control 
statements that have been written on a direct access device and then 
executes the programs identified on the EXEC statemients of the 
procedure. 
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Besides identifying the procedure on the EXjiC stateir.ent, you can 
assign values to syitifcolic parameters and override paraireters that are 
coded on the EXEC statements contained in the procedure. You follow the 
EXEC statement with DD statements when you want to override DD 
statements in the procedure or add DD statements to the procedure. 

When an in-stream procedure is written as part of the system output 
listing (i.e., MSGLEVEL={1, 0) , M3GLEVEL= (1,1) , ^j3GLEVEL=l , or ;^SGLEVEL=2 
is coded on the JOB statement) , the procedure statements can be easily 
identified. An ++ appears in coluirins 1 and 2 of a procedure statement 
that you did not override; +// appears in columns 1 and 2 of a procedure 
statement that you did override; ++* appears in column 1 through 3 of a 
procedure statement, other than a comment statemient, that the system 
considered to contain only comments; and *** appears in col\amns 1 
through 3 of a comment statement. In addition, if tne procedure 
contains symbolic parameters and you assign values to these on the EXEC 
statement that calls the procedure, the output listing will show the 
symbolic parameters and the values assigned to them. 



Assigning Values to Symbolic Parameters 

The cataloged or in-stream procedure you call may contain symbolic 
paramieters. A symbolic parameter is characterized by a name preceded by 
an ampersand (&) and appears in the operand field of a cataloged or 
in-stream procedure statement or a DD statement used to override a ED 
statement in the procedure. A symbolic parameter stands as a symbol for 
a param.eter, a subparameter , or a value. Symbolic parameters are used 
so that the procedure can be modified easily when it is called by a job 
step. 

The following are examiples of symibolic parameters: 

//STEPl EXEC PGM=COB,PAR^J=•Pl,JgP2,P3• 

//DDl DD DSMAME=FIX,UMIT= &DEVICE ,SPACE=(CYL, ( &SPACE ,10)) 

//DD2 DD DSNAME=CHAG,UNIT=2400,DCB=ELKSIZE=iLENGTH 

Sym.bolic parameters must either be assigned values or nullified 
before the procedure is executed. There are two ways that a symbolic 
paramieter can be assigned a value: 

1. You assign a value to the symbolic parameter on the EXEC statement 
that calls the procedure. 

2. The PROC statement, which can appear as the first statement in a 
cataloged procedure and must appear as the first statement in an 
in-streami procedure, assigns a default value to the symbolic 
paraimeter . 

Any default value assigned to a symbolic parameter on the PROC statement 
is overridden when you assign a value to the same symbolic parameter on 
the EXEC statement that calls the procedure. 

If cataloged procedures contain symbolic parameters, the installation 
should provide you with a list of the symbolic parameters used, what 
meaning is associated with each symbolic parameter, ana what default 
value has been assigned to each of the symbolic parameters on the PROC 
statement. (The PROC statement is optional for catalog procedures; 
therefore, there may be no default values assigned to the symbolic 
parameters used in a catalog procedure.) You need this information to 
determine, what the sym±)Olic parameter represents and to decide whether 
to use the default value or to assign a value to the symibolic parameter 
on the EXEC statement that calls the procedure. 
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To assign a value to a symbolic parameter, you code on the EXEC 
statement that calls the procedure: 

symbolic paraiTieter=value 

Omit the ampersand that precedes the symbolic parameter. For example, 
if the symbolic parameter 6NDMBER appears on a DD statement in the 
procedure, code NUMBER=value on the EXEC statement that calls the 
procedure. Any value you assign to a symibolic parameter is in effect 
only during the current execution of the procedure. 

There are some things you should keep in mind as you assign values to 
symbolic param.eters: 

1. The value you assign can be any length, but it cannot be continued 
onto another statement. 

2. If the value contains special characters, enclose the value in 
apostrophes (the enclosing apostrophes are not considered part of 
the value) . If the special characters include apostrophes, each 
m.ust be shown as two consecutive apostrophes. 

3. If, on the EXEC statement, you assign more than one value to a 
symbolic parameter, the first value encountered is used. 

4. If the sym.bolic parameter is concatenated with some other 
information (e.g., &JCENC.321), this information and the value you 
assign to the symbolic paramieter cannot exceed a combined total of 
120 characters. 



NULLIFYING A SYMEOLIC PARAMETER 

Besides assigning values to symbolic parameters, you can nullify a 
symbolic parameter, i.e., tell the system to ignore the symbolic 
parameter * 

To nullify a symbolic parameter, code on the HXEC statement that 
calls the procedure: 

symbolic parameter^ 

Omit the ampersand that precedes the symbolic parameter in the procedure 
and do not follow the equal sign with a value. 

For example, if a DD statement in a procedure named TIMES is 

//DD8 DD UNIT=1U03,UCS=SUCS1NFO 

and you want to nullify the symbolic parameter 6UCSINF0, you would code: 

//CALL EXEC TIMES, UCSINFO= 
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Example of Assigning Values to Symbolic Parameters 

1. The following are the first four statements of a cataloged 

procedure naired ASSEJyiBLE that contains symbolic parairieters. The 
PROC statement assigns a default to the syirbolic parameter 60BJi:CT 
and nullifies the symbolic parameter SLIST. Notice that the 
symbolic parameter &DEPT is not assigned a value on the PROC 
statement; therefore, the job step that calls this procedure miust 
assign a value to &DEPT. 

//DEF PROC OBJECT=NODECK,LIST= 

//ASM EXEC PGM=IEUASM,PARJyi=( 'LINECNT=50' , X 

// gLIST.LIST,&OEJECT) 

//SYSLIB DD DSNAME=SYS1.MACLIB,DISF=0LD 

// DD DSNAME=L1BRARY. &DEPT.Mii.CS,DIi3P=0LD 

When you call this procedure, you can assign values to the symbolic 
param.eters by coding: 

//STEP3 EXEC ASSEMBLE,DEPT=D8 2,OBJECT=DECK 

The value assigned to &OBJECT in this EXEC statement overrides the value 
assigned to SOEJECT in the PROC statement. since no value is assigned 
to £LIST in this EXEC statement, LIST is nullified -- because that is 
the default specified in the PROC statement. 

While the procedure is being executed, the first four statements of 
this procedure would appear as shown below. 

OBJECT=NODECK , LIST= 

PGM=IEUAS]yi,PARW=( 'LINECNT = 50' , X 

LIST, DECK) 

DSNAME=SYS1.MACL1B,D1SP=0ID 

DS NAM±.^LIERARY . D8 2MACS , DISP=^OLD 

The above example applies to in- stream procedures as well as cataloged 
procedures. However, you must refer to the name on the PROC statement 
of the in-stream procedure when calling tne procedure. 

The following is an in-stream procedure that contains symbolic 
parameters. The PROC statement m.arks the beginning of the in-strean 
procedure and in this example assigns defaults to symbolic parameters 
6D, 6U, 6V, and gS. The procedure is named INSTREAM. 

D=' (NEW,CATLG) ' , U=2311 , V= •SER=66655 ' , 

S=' (TRK, (1,1,1))' 

PGM=IEWL , PARM= ' XREF , LIST , NCAL ' 

SYSOUT=A 

DSNAiy!E=UTC,DISP=OLD,UlSlIT=2311,VOLU]yiE=SER=66651 

DSNAME=UTE,DISP=OLD,UNIT-2311,VOLUME=SER=66652 

DSNAME=£6LOAD,DISP=&D,UNIT=SU,VCLU^5E=&V, SPACE=&S 

When you call this procedure, you must code the name on the PROC 
statement on the EXEC statemient. You can assign values to the symbolic 
parameters by coding: 

//C.?y:,L EXEC INSTREAiM,D=' (NEW,PASS) • ,V="SER=66653" 

The values assigned to £D and £V in this EXEC statem.ent override the 
values assigned to these symbolic paramieters in the PROC statement. 

Since no value is assigned to SU OR &S, the defaults specified on the 
PROC statement are used when the procedure is executed. 
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//DEF 


PROC 


//ASM 


EXEC 


// 




//SYSLIB 


DD 


// 


DD 



//IN3TREAM 


PROC 


// 




//INI 


EXEC 


//SYSPRINT 


DD 


//SYSUTl 


DD 


//SYSLIN 


DD 


//SY3LMOD 


DD 


// 


PEND 



while the procedure is fceing executed, it would appear as shown 
below. 

//INSTREAM PROC D= ' ( NEW, CATLG) ' ,U=2311, V=' SER=66b5b ' , 

S=' (TRK, (1,1,1)) 
EXEC PGM=IEWL , PARM= * XREF , LIST , NCAL ' 
SYSOUT-A 

DSNA]yiE=UTC,DISP=OLD,UNIT=2311,VOLUiylE=SER=66651 
DSNAME=UTE,DISP=OLD,UNIT=2311,VOLUiyiE=SER=66652 
DSNAME=S&LOAD,DISP= (NEW, PASS) ,UNIT=2311, 
VOLUME=SER=66653,SPACE=(TRK, (1,1,1)) 

The PEND statement is printed but is not executed. 



// 




//INI 


EX 


//SYSPRINT 


DD 


//SYSUTl 


DD 


//SYSLIN 


DD 


//SYSLMOD 


DD 


// 





Overriding, Adding, and Nullifying Parameters on an EXEC Statement 



You can override, add, or hullify parameters coded on EXEC statements 
contained in a cataloged or in-stream. procedure. You make these changes 
on the EXEC statement that calls the procedure. You cannot, however, 
change the PGM parameter. The changes you make are in effect during the 
current execution of the procedure. 



OVERRIDING EXEC STATEMENT PAiiAMETERS 

To override an EXEC statement parameter in a procedure, identify on the 
EXEC statement that calls the procedure the param.eter you are 
overriding, the name of the EXEC statement on which the parameter 
appears, and the change to be made. The format required to override a 
parameter is: 

parameter. procstepname=change 

For example, if one of the EXEC statements in the procedure nairied flLL 
is : 

//STEP3 EXEC PGM=DEF,REGION=100K 

and you want to change REGION=100K to REGION=80K, you would code: 

//CALL EXEC FILL, REGION. STEP3=8 OK 



You can change more than one EXEC statement parameter in the 
procedure. For examiple, if one of the EXEC statements in the procedure 
name JKW is: 

//STEP2 EXEC PGM=OUT,TIME=(2,30) ,REGION=120K 
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and you want to change TIiy!E= (2 ,30) to TIME=4 and REGIOi.si=120K to 
REGION=200K, you would code: 

//STEP3 EXEC JKW, TIME. STEP2=4, REGION. STEP2=200K 
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If you want to change different parameters that appear on different 
jbXEC statements in the procedure, you must code all overriding 
parameters for one procedure step before those for the next step. For 
example, if the first three EXEC statements in a procedure named DART 
ares 

//STEPl EXEC PGM=JCTSa,PARM=^'*14863' ,REGICN=100K 
//STEP2 EXEC PGM=JCTRC,KEGION=80K 
//STEP3 EXEC PGM=JCTQD,C0ND=(8,LT) ,1IiYE=3 

You want to make the following modifications: 

1. Override the PARM parameter on the first EXEC statemient. 

2. Override the REGION parameter on the first EXEC statement. 

3. Override the REGION parameter on the second EXEC statement. 
U. Override the TIME parameter on the thira EXEC statement. 

The EXEC statement that calls the procedure would appear as: 

//STEPC EXEC DART, PARM. STEPl^** 86348 ' , X 

// REGION. STEP1=120K, REGION. STEP2=--100K, X 

// TIME.STEP3=(4,30) 

You can code an EXEC statement paramieter and omit the term 
"procstepname." When you do this, the procedure is modified as follows: 

• If the PARM parameter is coded, it applies only to the first 
procedure step. If a PARM paramieter appears in a later EXEC 
statement, it is nullified. 

• If the TIME parameter is coded, it applies to the total procedure. 
If the TIME parameter appears on any of the EXEC statements in the 
procedure, it is nullified. 

• If any other parameter is coded, it applies to every step in the 
procedure. If the parameter appears on an EXEC statement, it is 
overridden; if the parameter does not appear on an EXEC statement, 
it is added. 

For example, assume the ExEC statements in a procedure named RYIN 
are: 

//STEPl EXEC PGM=SECT,PARM=140947,REGICN=100K 
//STEP2 EXEC PGM=PARA,PARM=10 5600,CCND=EVEN 
//STEP3 EXEC PGM=SENT,PARM=L1644,REGICN=dOK 

YOU want to make the following modifications to the procedure: 

1. Override the PARM parameter in the first procedure step, and 
nullify all other PARM parameters in the procedure. 

2. Assign the same region size to all steps in the procedure. 

The EXEC statement that calls the procedure would appear as: 

//SPAA EXEC RYIN,PARM=L164U,REGION=136K 

While the procedure named RYIN is being executed, these three EXEC 
statements would appear as: 

//STEPl EXEC PGM=SECT,PARM=L164U,REGICiM=136K 
//STEP2 EXEC PGM=PARA,COND=EVEN,REGION=136K 
//STEP3 EXEC PGM=SENT,REGION=136K 
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ADDING EXEC STATEMENT PARAMETERS 

To add a parameter to an EXEC statement in the procedure, identify on 
the EXEC statement that calls the procedure the parameter you are 
adding, the name of the EXEC statement to which you want to add the 
paramieter, and the value you are assigning to the parameter. The format 
required to add a paramieter is: 

paramet€5r . procstepname=value 

Parameters you are adding and overriding for a step mu^st te coded before 
those parameters you are adding and overriding for tne next step. 

For example, if the first two EXEC statements of a procedure naned 
GLEAN are: 

//STEPl EXEC PGM=FAC,C0ND=(8,LT) 
//STEP2 EXEC PGiy!=UP,PARM=377fc8b 

You want to make the following modifications to tne procedure: 

1. Override the COND paramieter on the first EXr-C statement. 

2. Add the ROLL parameter to the first EXEC statement. 

3. Add the REGION parameter to the second EXxiC statement. 

The EXEC statement that calls the procedure would appear as: 

//STPA EXEC GLEAN, CONL. STEP 1==(1 2, LT ) , X 

// ROLL.STEPl=(NO,NO) , REGION . STEP2=--88K 



NULLIFYING EXEC STATEMENT PARAMETERS 

To nullify a parameter on an EXEC statement in the procedure, identify, 
on the EXEC statement that caills the procedure, the parameter you want 
to nullify and the name of the EXEC statement on which the parameter 
appears. The format required to nullify a parameter is: 

parameter. procstepname= 

Parameters that you are nullifying, overriding, and adding to a step 
must be coded before those for the next step. 

For example, if the first two EXEC statements of a procedure named 
GINN are: 

//STEPl EXEC PGM=INV,PARM='146,899' ,KB=R 
//STEP2 EXEC PGM=DET,PARM=XYA34,COND=(8 0,GT) 

You want to make the following modifications to the procedure: 

1. Nullify the PARM parameter on the first EXEC statement. 

2. Add the COND parameter to the first EXEC statement. 

3. Override the COND parameter on the second EXEC statement. 

The EXEC statement that calls the procedure would appear as: 

//STEPY EXEC GINN,PARM.STEPl^,C0ND.STEFl=(2b,Ew) , - 

// CCND.STEP2=^(8 0,GE) 
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Example o£ Overriding, Adding, and Nullifying Parameters on an EXEC 
Statement 

1. You want to call the following cataloged procedure nair.ed EStAP: 

//STEPA EXEC PGM=FLIER,PARM=7121190,ACCT={U8 05,UNif^SGN) 

//DDA DB DSNAME=LIBRARY. GROUP 67, DISP=CLD 

//DDB DD DSNAME=STAND.FIVE,DISP=CLD 

//STEPB EXEC PGM=VERSE,DPRTY=(11,13) ,PARN=780684,i<D=R 

//DDC DD UNIT=2311,SPACE=(TRK, (10,2)) 

//DDD DD DSNAME=COL,DISP=OLD 

//DDE DD DDNA]yih=IN 

You want to inake the following modifications to the procedure: 

1. Add the REGION parameter to both EXEC statements. 

2. Add the DPRTY parameter to the first EXEC statem.ent. 

3. Override the ACCT parameter on the irirst EXEC statement. 

4. iJullify the RD parameter on the second EXEC statement. 

5. Add the COND parameter to the second EXEC statement. 

The EXEC statement that calls the procedure would appear as: 

//MINC EXEC ESEAP,REGION=86K,DPRTY.STEPA=(ll,13) , X 

// ACCT. STEPA= (48 05,7 554) , RL . STEPB=, CCND .STEPB= ( 6 0, LE) 

The two EXEC statements in the procedure would appear as shown below 
while the procedure is being executed. These modifications do not 
appear on an output listing. 

//STEPA EXEC PGM=iLIER,FAR^J=71211^0,ACCT=(4805,7554) , X 

// REGION=86K,BPRTY=(ll,13) 

//STEPB EXEC PGM=VERSE,DPRTY=(11,13) ,kEGI0N=8dK, COND= ( 60, LE) 

2. You want to call the following in-streami procedure named IfJLINE: 

//INLINE PROC 

//STEPl EXEC PGM=COMP,ACCT= (7037,2361) ,KjiGI0N=8bK 

//DDl DD DSNAME=INEORM,DISP=OLD,UNIT=2311,VCLU^i=SER=7 5250 

//DD2 DD DSNAhE=LCJVvC,DISP=OLD,UNIT=2 311,VCIUiv;E=SER=7b250 

//STEP2 EXEC PGM=ChECKS,PARi^=21233 4,COKB=(5 0,LE) ,bCCT= ( 2001 , 0539) 

//DD3 DD DSNA^iE=PAY,DISP=CLD,UNIT^2311,VCLU^.E=SER=^JEMORY 

//DD4 DD DSNAME=IwCREAS,DISP=OLD,Ut;ilT^2311,VOLUME=SER^33333 

// PEND 

You want to miake the following modifications to the procedure: 

1. Add DPRTY paramieter to both EXEC statements. 

2. Nullify the REGION param.eter on the first EXEC statemient. 

3. Override the ACCT parameter on the second EXEC statement. 
The EXEC statement that calls the procedure would appear as: 

//CALLER EXEC INLINE ,DPRTY=^- (11 , 13) , REGION. oTEPl^^, ACCT . STEP2==^ ( 4710 , 
// 5390) 
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The two EXEC statements in the procedure would appear as shown below 
while the procedure is being executed. These modifications do not 
appear on an output listing. 

//STEPl EXEC PGM=COMP,ACCT=(7037,2 361) ,DPRTY=(11,13) 

//STEP2 EXEC PGiyi=CHECK,PARM=212334,CCND=(60,LE) , DPRTY= ( 11, 13) 

// ACCT=(U710,5390) 



Overriding, Adding, and Nullifying Parameters on a DD Statement 

You can override, add, or nullify parameters coded on a DD statement 
contained in a cataloged procedure. You make these changes at the time 
the procedure is called; these changes are in effect during the current 
execution of the procedure. Use one DD statement to override, add, and 
nullify parameters on the same DD statement in the procedure. 

OVERRIDING DD STATEMENT PARAMETERS 

To override a parameter on a DD statement in the procedure, you must 
include a DD statement following the EXEC statement that calls the 
procedure. The ddname of this DD statement must identify the DD 
statement that contains the parameter you are overriding and the 
procedure step in which the DD statement appears. Code, in the operand 
field of this DD statement, the parameter you are overriding and the 
change; or code a mutually exclusive parameter that is to take the place 
of a parameter. The format required for a DD statement following the 
EXEC statement is : 

//procstepname. ddname DD parameter=change 

or 
//procstepname. ddname DD mutually exclusive parameter=value 

For example, if one of the DD statements in a procedure step named 
STEP4 is: 

//DD2 DD DSNAME=ABIN,DISP=OLD,VOLUME=SER=54896,UNIT=2400 

and you want to change UNIT=2U00 to UNIT=180, you would code: 

//STEP4.DD2 DD UNIT=180 

When you code a mutually exclusive parameter on an overriding DD 
statement, the system replaces the parameter on the specified DD 
statement with the mutually exclusive parameter. For example, the 
parameters SYSOUT and DISP are mutually exclusive param:eters. If one of 
the DD statements in a procedure step named PRINT is: 

//DD8 DD SYSOUT=C 

and you do not want the data set printed, you could code: 

//PRINT. DD8 DD DUMMY, DISP= (NEW, DELETE) 

You have replaced the SYSOUT parameter with the DISP parameter and added 
the DUMMY parameter. (The DUMMY parameter causes this DD statement to 
define a dummy data set.) 
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You can change more than one parameter that appears on a DD statement 
in tne procedure. For exarrple, if one of the DD statements in a 
procedure step nairied STEPb is: 

//DDX DD DSNAME=FIES,DISP=OLL,UNIT=2U00-2,VOLUME=R£F=*.STEP2.DDC 

and you want this DD statement to define a nev* data set, you would code: 

//STEP5.DDX DD DSNAME=RVA1,DISP= (KEW ,KEEP) 

If you want to change parameters that appear on different DD 
statements in the same procedure step, the overriding DD statements must 
be in the same order in the input stream, as the corresponding DD 
statements in the procedure step. For example, if the first step of a 
procedure named AJG is : 

//STEPl EXEC PGK=MGK,REGION=8 0K 

//DDl DD DSNAME=LCNE,DISP= (NEW, DELETE), X 

// UNIT=2400,VOLUMF=SER=568998 

//DD2 DD UNIT=TAPE 

//DD3 DD UNIT=2311, DISP=(, PASS), SFACE={TRK, (20,2)) 

You want to make the following modifications to the procedure: 

1. Change the UNIT parameter on the first DD statement. 

2. Change the VOLUME parameter on the first DD statement. 

3. Change the SPACE paramieter on the third DD statement. 

The statements in the input stream would appear as: 

//CATP EXEC AJG 

//STEPl. DDl DD UNIT=2U00-3,VOLUME=SER=WORK18 

//STEPl. DD3 DD SPACE= (CYL, (4 , 1 ) ) 

If you want to change parameters that appear in different procedure 
steps in the cataloged procedure you are calling, the overriding DD 
statements must be in the same order as are the procedure steps. 

T he DCB p a rameter : If you want to change some of the subparameters in 
the DCB parameter, you need not recede the entire DCB parameter. 
Instead, code only those subparameters that you are changing and any 
mutually exclusive subparameters that are to replace particular 
subparameters. For example, if one of the DD statements in a procedure 
step named NED is: 

//DD3 DD DSNAhE=PER, DISP=(, KEEP), UNIT=2311,SPACE=(TRK, (88,5)) , X 

// DCB=(EUFNO=1,BLKSIZE=80,RECFM=F,BUFL=80) 

and you want to change BLKSI2.E=80 to BLKSIZE=320 and BUFL=80 to 
BUFL=320, you would code: 

//NED.DD3 DD DCB= (BLKSIZE=320, BUFL=320) 

The DCB subparameters BUFNO and RECFM remain unchanged. 
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ADDING DD STATEMENT PARAMETERS 

To add a parameter to a DD statement in the procedure, you must include 
a DD statement following the EXEC statement that calls the procedure. 
The ddname of this DD statement must identify the DD statement to which 
you are adding a parameter and the procedure step in which the BD 
statement appears. Code, in the operand field of this DB statement, the 
parameter you are adding. The format required for a DD statement 
following the EXEC statement is : 

//procstepname. ddname DD parameter=value 

For example, if one of the DD statements in a procedure step named 
STPTWO is: 

//DDM DD DSNAME=TYPE,DISP=(,KEEP),UNIT=2U00 

and you want to add the VOLUME parameter, you would code: 

//STPTWO. DDM DD VOLUME=SER--=569433 

If you want to add parameters or change parameters that appear on 
different DD statements, the overriding DD statemients must be in the 
same order in the input stream as the corresponding DD statements in the 
procedure. 



NULLIFYING DD STATEMENT PARAMETERS 

There may be paraiiieters on a DD statemient that you do not want to 
override, but you want the system to ignore. Also, when you modify a DD 
statement in a procedure by overriding certain parameters or adding 
parameters, there may be some parameters remaining that no longer have 
meaning for your data set definition but would effect processing of the 
data set. To temporarily remove these parameters, you can nullify them. 
(If you are replacing a parameter with a mutually exclusive parameter, 
do not nullify the parameter that is being replaced.) 

To nullify a parameter on a DD statement in the procedure, you must 
include a DD statement following the EXEC statement that calls the 
procedure. The ddname of this DD statement must identify the DD 
statement that contains the parameter you are nullifying and the 
procedure step in which the DD statement appears. Code in the operand 
field of this DD statement the parameter you are nullifying followed by 
an equal sign; do not follow the equal sign with a value. The format 
required for a DD statement following the EXEC statement is: 

//procstepname. ddname DD parameter= 

For examiple, if one of thei DD statements in a procedure step named 
SALLS is: 
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//DDP DD DSi;'lAME=STEP,DISP=OLD,UNIT=2314, X 

// VOLUME=SER=55697 8 

and you are overriding the DSNAME, DISP, and UNIT parameters, adding the 
DCB parameter, and want the VOLUME parameter ignored, you would code: 

//SALLS. DDP DD DSNAME=£STEMP, DISP= ( , PASS) , UNIT=2i»00-2 , X 

// DCB=(DEN=2,TRTCH=ET) ,VOLUME= 
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To nullify the DCB parameter, each DCB subparaipeter must be nullified 
individually. For example, if a DD statement contains 

DCB=(RECFM=FBA,BLKSIZE=160,LRECL=8 0) , then DCB= (RECFM= ,BLKSIZE= ,LRECL=) 
must be coded on the overriding DD statement in order to nullify the DCE, 
parameter. 

To nullify a DUMMY parameter, code the DSNAME paramiCter on the 
overriding DD statement, but do not use the data set name NULLFILE. 
(Coding DSNAME=NULLFILE has the same effect as coding the DUMMY 
parameter . ) 

Caution : When you are overriding a procedure DD statement that contains 
the SPACE parameter and the overriding DD statement defines an existing 
data set,, be sure to nullify the SPACE parameter. VJhen a secondary 
quantity is coded on the procedure DD statement, the systemi uses this 
value to assign additional space to the data set instead of the 
secondary quantity you m.ay have specified when the data set was created. 
Also, the RLSE subparameter, when specified on the procedure statement, 
causes the system to release any of the existing data set's unused 
space - 

If you want to nullify, add, or override parameters that appear on 
different DD statements, the overriding ED statements m;ust be in the 
same order in the input stream as the corresponding DD statements in the 
procedure. • 



Example of Overriding, Adding, and Nullifying Parameters on a DD 
Statement 



You v/ant to call the following procedure named SALL: 



PGM=GLF14 

DSNAME=XTRA . LEVEL , DISP=OLD 

DSNAME-CONDS , DISP= ( , PASS) , UNIT=2400 

DUMiMY , D3NAME=LAST , VOLUME=REF=* . DDll , DISP= ( , CATLG) 

PGM=FAIR 

DSNAME=*.STP1.DD12,DISP= (OLD, DELETE) 

DSNAME=JETZ,DISP= (NEW, KEEP) ,UNIT=2 311, 

SPACE=(CYL, (3,1) ,RLSE) 

SYSOUT^G 



//STPl 


EXEC 


//DJll 


DD 


//DD12 


DD 


//DD13 


DD 


//STP2 


EXEC 


//DD21 


DD 


//DD2 2 


DD 


// 




//DD2 3 


DD 



You want to modify the procedure as follows: 

1, Change the data set name on the statement named DD12 from CONDS to 
C8495. 

2.. Add the VOLUME parameter to the statement named DD12. 

3. Nullify the DUMMY paramieter on rhe statement named DD13. 

U. Change the disposition on the statement named DD21 irom DELETE to 

KEEP. 

b. Define an existing data set on the statement named ED22. 

6. Add the parameter UNIT on tne statement named DD23. 

7. Add the parameter SPACE on the statement named DD23. 
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The EXEC statement that calls the procedure and the overriding DD 
statements that follow it would appear as: 

//CALL EXEC SALL 

//STP1.DD12 DD DSNAME=C8U95,VOLUF:E=SER=97 93 5U 

//STP1.DD13 DD DSTSiAME=LAST 

//STP2.DD21 DD DiSP= (OLD, KEEP) 

//STP2.DD22 DD SPACE=,DSNAME=GR1833 ,DISP=OLD, LAB£L= ( , NL) , 

// VOLU]y!E=SER=577632 

//STP2.DD23 DD UNIT=2314 ,SPACE= (TRK , (loO , 15) ) 

The cataloged procedure would appear as shown below while the 
procedure is being executed. These modifications do not appear on an 
output listing. 

//STPl EXEC PGM=GLF14 

//DDll DD DSNAME=XTRA. LEVEL, DISP=OLD 

//DD12 DD DSNAME=C8U95,DISP= {,PASS) ,UNIT=2a00, 

// VOLUME=SER=97 9354 

//DD13 DD DSNAME=LAST,VCLU]V]E=REF=*.DD11,DISP=(,CATLG) 

//STP2 EXEC PGM=FAIR 

//DD21 DD DSNAME=*.STP1.DD12,DISP=(0LD,KEEP) 

//DD22 DD DSNAME=GR1833,DISP=0LD,UNIT = 2311,LABEL=(,1SIL) , 

// VOLUME=SER=577632 

//DD23 DD SYSOUT=G,UNIT=23m,SPACE=(TRK, (150,15)) 

2. You want to call the following in-streaim procedure named CARDS: 

//CARDS PROC 

//STEPA EXEC PGM=FIGURE 

//DDAl DD DSNAME=NUMBERS,DISP=OLD 

//DDA2 DD DSNAME=PROCESS,DISP=(,PASS) ,UNIT=2311, 

// SPACE=(TRK, (1,1,1)) 

//STEPB EXEC PGM=RESULT 

//DDBl DD DSISIAME=VSC,DISP=OLD 

//DDB2 DD DSNAME=*. STEPA. DDA 2, DISP=(CLD, KEEP) 

//DDB3 DD SYSOUT=C 

// PEND 

You want to modify the procedure as follows: 

1. Change the data set name on the DDAl statement from NUMBERS to 
NAMES . 

2. Add the VOLUME parameter to the DDA2 statement. 

3. Add the parameters UNIT and SPACE on the DDB3 statement. 

The EXEC statement that calls the procedure and the overriding DD 
statements that follow it would appear as: 

//CALL EXEC CARDS 

//STEPA. DDAl DD DSNAME= NAMES 

//STEPA. DDA2 DD VOLUM]i,=SER=5858 

//STEPB. DDB3 DD UNIT=2311 ,SPACE= (TRK, (150 , 15) ) 
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//STEPA 


EXEC 


//DDAl 


DD 


//DDA2 


DD 


// 




//STEPE 


EXEC 


//DDBl 


DD 


//DBB2 


DD 


//DEB 3 


DD 



The in- stream procedure would appear as shown below while the 
procedure is beinq executed. These rriodif ications do not appear on an 
output listing. The PROC statement is processed only when it contains 
symbolic parameters . 

PGM=FIGURE 

DSNAME^ NAMES , DISP=OLD 

DSNAME=PROCESS, DISP= ( , PASS) ,UNIT=2311 , 

SPACE=(TRK, (1,1,1)) ,VCLUiyiiLS=SER=58 58 

PGM=RESULT 

DSNAiyi£=VSC,DISP=OLD 

DSNAMF=* . STEPA . DDA2 , DISP= (OLD , KEEP ) 

SYSOUT=C,UNIT=2311,SPACE=(TRK, (150,15)) 



Overriding DD Statements That Define Concatenated Data Sets 

when a concatenation of data sets is defined in a cataloged procedure 
and you attempt to override the concatenation with one Uu statement, 
only the first (named) DD statement is overridden. To override others, 
you must include an overriding DD statement for each DD statement; the 
DD statements in the input stream must be in the same order as the DD 
statements in the procedure. The second and subsequent overriding 
statements must not be named. If you do not wish to change one of the 
concatenated DD statements, leave the operand field blank on the 
corresponding DD statement in the input stream. (This is the only case 
where a blank operand field for a DD statement is valid.) 

For example, suppose you are calling a procedure that includes the 
following sequence of DD statements in STEPC: 

//DDU ED DSNAME=A.B.C,DISP=OLD 

// DD DSNAME=STRP,DISP=OLD,UiNlIT=2311,VOL=SER=Xl2182 

// ED DSNAME=TYPE3,DI3P=OLD,UNIT=2311,VOLUME=SER=BL1U2 

// DD DSlSiAME=A.B.D,DISP=OLD 

If you want to override the DD statements that define the data sets 
named STRP and A.B.D, the sequence of DD statements in the input stream 
would appear as : 

//STEPC. DD4 DD 

// DD DSNAME=INV.CLS,DISP=OLD 

// DD 

// DD DSNAPJE=PAL8,DISP=OLD,UNIT=2311,VOL=SER=125688 



Adding DD Statements to a Procedure 

You can add DD statements to a procedure when you call the procedure. 
These additional DD statements are in effect only while the procedure is 
being executed. 

To add a DD statement to a procedure step, follow the EXEC statement 
that calls the procedure and any overriding DD statements for that step 
with the additional DD statement. The ddname of this DD statement must 
identify the procedure step to which this statement is to be added and 
must be assigned a name that is different from all the ddnames in the 
procedure step. The format required for a DD statement following the 
EXEC statement is: 

//procstepnaine. ddname DD parameters 
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For exairple, if the first step of a cataloged procedure named >'!ART 
is : 

//STEPl EXEC PGM=DATE 

//DDM DD DSNAME = BPS(IWE]yiG) ,DISP=^CLD, : 

// UNIT=2311,VOLUME=SER=5 54 9 82 

//DDN DD UNIT=SYSC;E 

You want to make the following modifications to the procedure: 

1. Change the UNIT parameter on the statem.ent named LDd. 

2. Add a DD statement. 

The statements in the input stream would appear as: 

//PROC EXEC MART 
//STEPl. DDN DD UNIT=18 
//STEPl. DDO DD UNIT=181 

In PCP, if you are adding more than one DL statement to a procedure 
step and one of the statements is a DD * or DD DATA statement, the DD * 
or DD DATA statement must be last. 



Example of Adding DD Statements to a Procedure 

1. You want to call the following procedure named D99 5A: 

//SA EXEC PGM=A1SIALY 

//DDAl DD DSNAME=PROJ.C843,DISP=OLD 

//DDA2 DD DDNAME=SYSIN 

//DDA3 DD SYSOUT^B 

//SB EXEC PGM=MANMC3 

//DDBl DD UNIT=2400 

//DDB2 DD UNIT=2U00 

//DDB3 DD DSNAME=X5a,VOLUME=SER=(36544, 3654 5) , 

// UNIT= (2400,2) ,DISP=(OLD,KEii;P) 

You want to modify the procedure as follows : 

1. Supply the data set definition for the DDA2 statement by adding a 
DD statement. 

2. Change the SYSOUT parameter on the DDA3 statement to UNIT=14 03. 

3. Add a DD statement to the step named SB. 

The EXEC statement that calls the procedure and the overriding and 
additional DD statements that follow it would appear as: 

//PROCED EXEC D9 95A 

//SA.DDA3 DD UNIT=1403 ,DISP=WEW 

//SA.SYSIN DD * 



data 



/* 

//SB.DDB4 DD UNIT= (2400 , , SEP= (DDEl , DDE2) ) 
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The cataloged procedure would appear as shown below while the 
procedure is being executed. These irodif ications do not appear on 
output listing. 



//SA 


EXEC 


//DDAl 


DD 


//DDA2 


DB 


//DDA3 


DD 


//SE 


EXEC 


//DDBl 


DD 


//DBB2 


DD 


//DDB3 


DD 


// 




//DDBU 


DD 



PGM=ANALY 

DSNAME=P:RCJ.C8U3,DISP=CLD 

* 

UNIT=1U03,DISP=NEW 

PGM=MANM03 

UNIT=2400 

UNIT=2U00 

DSISlAME=X54 , VOLUME=SER= (36544,36 54 5), 

UNIT=(2400,2) ,DISP=(OLD,KEEP) 

UNIT=(24 00, ,SEP=(DDB1,DDB2)) 



2. You want to call the following in-streair, procedure named V^OKK 



//WORK PROC 

//STPl EXEC 

//DDl DD 

//DD2 DD 

// PENL 



PGM=PROD 

DSNAME=PROJECT , DISP=OLD 
DDNAME=SYSIN 



You want to modify the procedure by supplying the data set definition 
for the DD2 staterrient by adding a DD statement. 

The EXEC statement that calls the procedure and the additional DD 
statement that follows it would appear as 

//ADD EXEC WORK 

//STPl.SYSIN DD * 



data 



/* 

The in- stream procedure would appear as shown below while the 
procedure is being executed. These modifications do not appear on the 
output listing. 

//STP EXEC PG^J=PROD 

//DDl DD DSNAME=PRCJECT,DISP=OLD 
//DD2 DD * 
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Writing Procedures: Cataloged and In-stream 



Why Catalog Job Control Statements 

Applications performed at your installation on a regular basis and 
applications that require many control statements can fce simplified when 
the control statements for these applications are cataloged. Once the 
job control statements for an application are cataloged on the procedure 
library, any programmer who wants to perform the application need only 
submit a JOB and EXEC statement. On the EXEC statement, he refers the 
system to the control statements required to perform the application. 
If there are modifications the programmer wants to make for the duration 
of the job step, he assigns values to symbolic parameters on the EXEC 
statement and follows the EXEC statement with overriding BD statemicnts. 



Why Use In-stream Procedures 

In-stream procedures appear within the job streami instead of in the 
procedure library. Like cataloged procedures, they eliminate the 
necessity of repeating the same set of control statemients in a job. An 
in-stream procedure can be executed any numiber of tim.es during a job in 
which it appears and fifteen uniquely named in-stream procedures can 
appear in one job. In-stream procedures can be miodified just as 
cataloged procedures. They also provide you with a means of testing 
procedures before adding them to the procedure library as cataloged 
procedures. Because an in-stream procedure may exist in the form of 
cards, it can be considered a "portable procedure" in that it can easily 
be moved from one input stream to another. 

I THE CONTENTS OF CATALOGED AND IN-STREAM PROCEDURES 

Cataloged and in-stream procedures contain one or more EXEC statemients, 
each followed by associated DD statements. Each EXEC statement 
identifies the program to be executed, and the DD statements that follow 
define the input, output, and work data sets to be used by the program. 
Each EXEC statement and its associated DD statements are called a 
procedure step. 

Cataloged and in-stream procedures cannot contain: 

1. EXEC statements that refer to other cataloged procedures. 

2. JOB, delimiter, or null statements. 

3. DD statements with the ddname JOBLIB , 

^. DD statements with * or DATA coded in the operand field. 

A cataloged procedure can contain a DD statement with the ddname 
STEPLIB. If a procedure step requires use of a program in a private 
library other than SYSl.LINKLIB, you define that library on this DD 
statement. If the DD statement is not overridden when the procedure is 
called, it makes the private library available to the step. (For 
information on the STEPLIB DD statement, see the chapter "Special 
Ddnamies" in Section IV of this publication.) 

For ease in modifying a cataloged procedure, you can include symbolic 
parameters in the procedure. How to use symbolic parameters is 
described next. 
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USING oYMBOLIC PARAI'.LTEi^S IN A PROCEDURE 

Wfjen you prepare the control stateir:ents that ycu plan to catalog or use 
as an in-strearri procedure, you can include symbolic paraneters. A 
symbolic parameter is characterized by a naire preceded by an ampersand 
(S) and appears in the operand field of a cataloged procedure statement. 
A symbolic parameter stands for a parameter , a subparameter, or a 
value. 

Symbolic parameters allow a programmier who calls the procedure to 
easily modify the procedure for the duration of the job step. Vvhen the 
programmier calls the procedure, he assigns values to the symibolic 
param.eters on the EXEC statement. When you prepare control statements 
that you plan to catalog, you can include a PROC statement and assign 
default values to any of the symbolic parameters that are included. 
When you prepare control statements to be used as an in-stream^ 
procedure, you must include a PROC statement which can be used to assign 
default values to any of the symbolic parameters that are included. 

A symbolic parameter is one to seven alphameric and national (#,a,$) 
cnaracters preceded by a single ampersand. The first character must be 
alphabetic or national, Gince a sinale ampersand defines a symbolic 
parametej:, you code double ampersands when you are not defining a 
symbolic paramieter. For exam.ple, if you want to pass 5U3&LEV to a 
processing program by means of the PARM parameter on an EXEC statement, 
you must code PARM= ' 54&&Lir.V * - The system treats the douPle amipersands 
as if a single amipersand has been coded, and only one ampersand appears 
in the results. 

The following are examiples of symbolic parameters: 

//STEPl EXEC PGM=C0B.PAR^]=*P1, &P2,P3' 

//DDl DD DSNAiyiE=S&FIX,UNIT =&DEVICE ,SPACE=(CYL, ( &SFACE ,10)) 

//DD2 CD DSNAME=6&CHAG,UNIT=2U00,DCB=BLKSIZE=iLENGTH 

Keyword parameters that can be coded on an EXEC statement cannot be 
used to define symbolic param.eters. For example, gPGM and &REGION 
cannot be used as symbolic parameters. 

Any parameter, subparamteter , or value in the procedure that may vary 
each time the procedure is called is a good candidate for definition as 
a symbolic parameter. For example, if different values can be passed to 
a processing program by means of the PARM parameter on one of the EXEC 
statements, you might define the PARM parameter field as one or miore 
symbolic parameters, PARM= &ALLVALS or PARM=gDECK6C0DE. 

If symbolic parameters are defined in the cataloged or in-stream 
procedures used at your installation, the definitions should be 
consistent. For example, every tim.e the programmier is to assign his 
department number to a symbolic parameter, no m.atter which procedure he 
is calling, the symbolic parameter could be defined as &DEPT. In 
different procedures you could code ACCT= (43877, SDEPT) and 
DSNAMF,=LIBRARY. &DEPT.MACS. The programmer would assign his department 
number on the EXEC statement that calls the procedure whenever &DEPT 
appears in a procedure. Of course, in order for the programmer to know 
that he is to assign his department number to the symbolic parameter 
&DEPT, the installation miust make this information available to all the 
programmers that may be using the cataloged procedures. 

You can define two or more symbolic parameters in succession without 
including a comma to delimit the symbolic parameters, for example, 
&P1&P2. You can also define a portion of a parameter, subparameter , or 
value as a symbolic paramieter. You do this by placing the symbolic 
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parameter before, after, or in between the information that is not 
variable. 

If you place a symbolic parameter afte r scire information that does 
not vary, it is not necessary to code a delimiter. The system 
recognizes a symbolic parameter when it encounters the single ampersand. 

If you place a symbolic parameter before some information that does 
not vary, a period may be required following the symbolic parameter to 
distinguish the end of the symbolic parameter and the beginning of the 
information that does not vary. A period is required following the 
symbolic parameter when: 

1. The character following the symbolic parameter is an alphabetic or 
numeric character. 

2. The character following the symbolic paramieter is a left 
parenthesis or a period. 

In these cases, the system recognizes the period as a delimiter, and the 
period does not appear after a value is assigned to the symibolic 
parameter. (A period will appear after a value is assigned to the 
symbolic parameter when two consecutive periods are coded.) 

The following examples are valid ways of combining symbolic 
paramieters and information that does not vary. 

Placing a symbolic parameter after information that does not vary: 

1. LIBRARY (&^!lEiMBER) 

2. USERLIB.&LEVEL 

Placing a symbolic parameter before information that does not vary: 
1. '60PTION+15' 



2. 6PASS.AU3B8 

The period is required because an alphabetic character follows the 
symbolic parameter. 

3. &URN0.5U328 

The period is required because a numeric character follows the 
symbolic parameter. 

4. & LIBRARY. (MEMO 

The period is required because a left parenthesis follows the 
symbolic parameter . 

5. &FILL. .GROUPS 

A period is to appear in the results; therefore, two consecutive 
periods are coded. 

When a value is assigned to the symbolic parameter, this value and 
the parameter, subparameter , or value that this is a portion of cannot 
exceed 120 characters. 

The programmer who calls a procedure assigns values to the symiiDClic 
parameters contained in the procedure. xie can also nullify symbolic 
parameters. A delimiter, such as a leading commia or a trailing comma, 
next to a symbolic parameter is not automatically removed when the 
symbolic param.eter is nullified. For example, if the operand field 
contains VOLUME=dER= ( 111111, 6KEY) , the comma preceding 6KEY is not 
removed when &KEY is nullified. If the symbolic paramieter that is 
nullified is a positional parameter, a comma must remain to indicate its 
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absences. In other cases, a delimiter that is not removed when the 
syinbolic parameter is nullified may cause a syntax error. To help tne 
programmer who nullifies a symbolic parameter avoid this error 
condition, define those symbolic parameters that may be nullified 
without the deliniter. For example, you could code 

VOLUiyiE=-S£;R=(llllll£KEY) . The delimiter is included when a value is 
assigned to the symbolic parameter. For example, the programmer would 
code KEY=' ,222222' . 

A cataloged or in-stream procedure statement m.ay utilize DDNAKE and 
DCB parameters to define data in the input stream. Such a statement 
should not contain symbolic parameters when the automatic SYiSIN batching 
reader is used. (Information on the cataloged procedure for the 
automiatic SYolN batching reader is contained in the chapter "System 
Reader, Initiator, and Writer Cataloged Procedures" in tne System 
P rogram m er's Guide publ ic at ion . ) 

The pkO C statement ; When establishing cataloged or in-stream procedures 
tnat contain symbolic parameters it is generally good practice to assign 
default values to the symibolic parameters. Inese default values are 
used if the programmer who calls the procedure does not assign values to 
one or more of the symbolic parameters. 

You assign default values on a PRCcj statemient. The PROC statement is 
optional in cataloged procedures; if it is used, the PROC statement must 
be the first statement in the procedure. The PROC statement is 
described in Section X of this publication. The PEND statemient which is 
used to mark the end of an in-stream procedure is described in Section 

lA. 



ADDING AND MODIFYING CATALOGED PROCEDURES 

You add procedures to the procedure library by using the lEBUPDTE 
utility program. You also use this utility program to permanently 
modify existing proedures. ilow to use this utility program for adding 
and modifying cataloged procedures is descrited in the chapter "The 
lEBUPDTE Program" in the Utilities publication. 

If you use MFT or MVT when you add a cataloged procedure to the 
procedure library, that procedure cannot be executed before the job that 
adds it to the procedure library terminates. If you use MET or MVT when 
you modify an existing cataloged procedure, the operator m.ust be 
notified. What the operator must do before he allows the job to be 
executed is described in tne chapter "How to Kun Jobs That Update System 
Data Sets" in the Operator's Guide publication. 
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when a job step abnormally terminates, you may have to resubmit the job 
for execution. This means lost computer time and a delay in obtaining 
the desired results. To reduce these effects, you can use the restart 
facilities . 

If a job step abnormally terminates or if a system failure occurs in 
a system with lyJFT or MVT, the restart facilities allow you to request 
that the job step be restarted either at the beginning of the step (step 
restart) or within the step (checkpoint restart). Furthermore, restart 
can occur automatically after abnormal termination, or it can be 
deferred until the job is resubmitted. 



Restarts 

For automatic step restart to occur, the RD parameter must request it on 
the JOB statement or on the EXEC statement associated with the step that 
abnormally terminates. (The RD parameter on the JOB statement is 
described in Section II of this publication; the RD parameter on the 
EXEC statement is described in Section III.) Automatic checkpoint 
restart can occur only if a CHKPT macro instruction is executed in the 
processing program prior to abnormal termination. 

If restart is deferred until the job is resubmitted, the RESTAKT 
parameter must be coded on the JOB statemient of the resubmitted job. 
(The RESTART parameter is described in Section II of this publication.) 
The RESTART parameter identifies the step or the step and the checkpoint 
at which execution is to be resumed. A deferred restart may be 
initiated regardless of how the resubmitted job was previously 
terminated (normially or abnormally) and regardless of whether an 
automatic restart occurred during the original execution. 

AUTOMATIC STEP RESTART 

If an abnormally terminated step is to be automatically restarted, the 
RD parameter must be coded as RD=R or RD=RNC. Execution resumes at the 
beginning of the abnormally terminated step. 

AUTOMATIC CHECKPOINT RESTART 

After an automatic checkpoint restart, execution resumes at the 
instruction immediately following the last CHKPT macro instruction that 
was successfully executed in the abnormally terminated step. An 
automatic checkpoint restart cannot occur if you suppress the action of 
the CHKPT macro instruction; you do this by coding RD=lSiC or RD=RNC. 
Also, an automatic checkpoint restart cannot occur if you code RD=NR; 
nowever, RD=NR allows the CHKPT macro instruction to establish a 
checkpoint . 

DEFERRED STEP RESTART 

To perform a deferred step restart, the RESTART parameter must identify 
the step at which execution is to be resumed. Steps preceding the 
restart step are interpreted but are not initiated. 
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since dispostion processing occurred during trie original execution of 
the job, you may have to rrodify control stateirents associated with the 
restart step before you resubmit the job. Modifications iray be required 
in two cases: 

1. A data set was defined as NhiW during the original execution. If it 
was created during the original execution, you must change the data 
set's status to OLD, define a new data set, or delete the data set 
before resubinitting the job. 

2. A data set was passed and was to be received by the restart step or 
a step following the restart step. If the passed data set is not 
cataloged, you must supply, in the receiving step, volume serial 
numbers, device type, data set sequence num.ber, and label type. 
(Label type cannot be retrieved from the catalog.) 

To limit the number of modifications required before you resubmit the 
job, you can assign conditional dispositions during the original 
execution. (Data sets assigned a temporary name or no name can only be 
assigned a conditional disposition of DELETE.) If deferred step restart 
will be performed, conditional dispositions should be used: 

• To delete all new data sets created by the restart step. 

• To keep all old data sets used by the restart step, other than thos€5 
passed to the step, (If a nontemporary data set is defined as 
DISP- (OLD, DELETE) , it is very important that you assign a 
conditional disposition of KEEP.) 

• To catalog all data sets passed from steps preceding the restart 
step to the restart step or to steps following the restart step. 

Additional changes can be made to your control statements before 
resubmitting the job- For example, you can vary device and volume 
configurations and request step restart on an alternate system with the 
same configuration as used originally. You can also make changes to 
your data. 

DEFERRED CHECKPOINT RESTART 

TO perform a deferred checkpoint restart, the RESTART parameter must 
identify the step and the checkpoint at which execution is to be 
resumed. The SYSCHK DD statement, which defines the checkpoint data 
set, must also be included. (The SYSCHK DD statement is described in 
the chapter "Special Ddnames" in Section IV. 

An internal representation of your statements is kept as control 
information within the system. Some of the control information for the 
restart step or steps following the restart step may have to be miodified 
before execution can be resumed at a checkpoint. The following 
modifications for the restart step are automatically made by the system,, 
using information contained in the checkpoint entry: 

• The status of data sets used by the step is changed from NEW to OLD. 
(If ci new data set was assigned a nonspecific volume and had not 
been opened before the checkpoint was established, this change is 
not made. ) 

• If nonspecific volumes were requested for a data set used in the 
restart step, the assigned device type and volume serial numbers are; 
made part of the control information. 

• For a multivolume data set, the volume being processed when the 
checkpoint was established is mounted. 
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The only required modification that you must make to a control 
statement is to supply certain information about a data set that was 
being passed by a step preceding the restart step to a step following 
the restart step. You must supply, in the receiving step, volume serial 
numbers, device type, data set sequence number, and label type. You 
will not have to make these modifications if, during the original 
execution, you assigned a conditional disposition of CATLG to such data 
sets. If the data is cataloged, the system can retrieve this 
information from the catalog. (Label type cannot be retrieved from, the 
catalog.) You should also use conditional dispositions to keep all data 
sets used by the restart step. Data sets assigned a temporary name or 
no name can only be assigned a conditional disposition of DELETE. 
Therefore, if you plan a deferred checkpoint restart, you should not 
define you data sets as temporary. (For any nonteraporary data set that 
may be deleted, it is very imiportant that you assign a conditional 
disposition of KEEP.) 

Before resubmitting the job for checkpoint restart, you can make 
otner miodifications to control statements associated with the restart 
step or steps following the restart step. The following items apply to 
the step in which restart is to occur: 

• The DD statemients in the restart step can be altered, but the 
statements must have the same names as used originally. You can 
also include additional DD statemients. 

• If a data set was open at the time a checkpoint was established and 
restart is to begin at that checkpoint, DD statements in the restart 
step can define the samie data set. If there is no need to process a 
data set after restart, you can define the data set by coding the 
DUMMY parameter or DSIsiAME=ISiULLFILE on a ED statement provided that; 
(1) the basic sequential access method (BSAM) or the queued 
sequential access method (QSAM) was being used to process the data 
set when the checkpoint was established, (2) the data set is not the 
checkpoint data set that is being used to restart the job step, and 
(3) the job step is not restarted from, a cbecKpcint tnat was 
established in an end-of-volume exit routine for tne data set. The 
name of the DD statement miust be the same as the one used for the 
data set during the oriainal execution of your prooram. 

• If DUMMY is not specified, the DD statemients must define the same 
data sets. Also, the data sets must not nave been mcved on the 
volume or onto another volume. 

• If a data set was not open when the checkpoint was established and 
is not needed during restart, you can replace the paramieters used to 
define the data set with the DUMMY paramieter. 

e You can alter the data in the restart step. if you omit the data, a 
delimiter statement (/*) is not required, unless the data was 
preceded by a DD DATA statement. 

Modifications you might want to make to control statements following 
the restart step are: varying device and volumie configurations, 
altering data, and possibly, requesting checkpoint restart on an 
alternate system with the same configuration as used originally. If the 
parameters PGM, COND, SUBALLOC , and VOLU^.E=KEF refer to steps preceding 
the restart step, you must resolve these references before resubmitting 
the job. (A backward reference of VOLUME=REF is allowed if the 
referenced statement includes VOLUME=SER= (serial number).) 
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Examples of Using the Restart Facilities 

1. The following control statements illustrate the preparations that 
would be made for either an automatic step or checkpoint restart 
before the job is submitted for the first time. 

5U321 , A .USER , MSGLEVEL= (1,0) ,RD=K 

PGM=SIMPSORT 

DSN=SORTIN,VOL=^SER=100U6 8,UNIT=2400, X 

DISP= COLD, DELETE) 

DSrJ=IlTV(+l) ,UNIT=2311,VOL=SER=55533U, X 

SPACE=(3200, (200,100)) ,DISP= (NEW,CATLG) 

DNIT=2400,DISP= (NEW, DELETE) 

UNIT=2400,DISP= (NEW, DELETE) 

UNIT=2400,DISP= (NEW, DELETE) 

PGM=MYMERGE 

DSN=INV(+1) ,DI3P=CLD 

DSN=M5,VCL=SEK=(092501,092 50 2,092b03), X 

UN1T=(2U00, 3) ,DISP=(CLD,KEEP) 

DSlNl=M6,UNIT=2a00,VOL=SER=(100101, 100102, X 

100103) ,DISP= (NEW, KEEP) 



//STMRG3 


JOB 


//STEPl 


EXEC 


//INPUT 


DD 


// 




//OUTPUT 


DD 


// 




//WORKl 


DD 


//W0RK2 


DD 


//CBKPT 


DD 


//STEP 2 


EXEC 


//MERGl 


DD 


//MERG2 


DD 


// 




//RESULTS 


DD 


// 





liere, the RD parameter requests step restart for any abnormally 
terminated job step. In STEPl, the DD statement CHKPT defines a 
checkpoint data set. For this step, once a CHKPT macro instruction 
is executed, only automatic checkpoint restart is performed. An 
automatic checkpoint restart cannot occur in STEP2 since a 
checkpoint data set is not defined. 

The following control statements illustrate the preparations that 
would be m.ade for either an automatic or deferred step restart 
before the job is submitted for the first time. 

54321, A. USER, MSGLEVEL= (1,0) ,RD=R 

PGM= SIMP SORT 

DSN=SORTIN,VOL=SER=100 468,UNIT=2400, X 

DISP=( OLD, DELETE, KEEP) 

DSw=IivIV(+l) ,UNIT=2311,VOL^SER=555334, X 

SPACE= ( 3200 , ( 200 , 100) ) ,DISP= (NEW ,CATLG , DELETE) 

UNIT=2400,DISP^ (NEW, DELETE) 

UNIT=2U00,DISP= (NEW, DELETE) 

PGlyl=iyiYMERGE 

DSN=IiW(+l) ,DISP=CLD 

DSN=M5,VOL=SER=(092501, 092502, 092503) , X 

UNIT= (2400,3) ,DISP= (OLD, KEEP) 

DSN=Nj6,UNIT=2400,VOL=SER=(100101, 100102, X 

100103) ,DISP= (NEW, KEEP, DELETE) 



//STMRG3 


JOB 


//STEPl 


EXEC 


//INPUT 


DD 


// 




//OUTPUT 


DD 


// 




//WOc^Kl 


DD 


//W0KK2 


DD 


//STEP2 


EXEC 


//lyJERGl 


DD 


//MERG2 


DD 


// 




//RESULTS 


DD 


// 





If you are resubmitting this job for step restart, you must code 
tne RESTART parameter on the JOB statement and identify the step at 
which execution is to be resumed. If execution is to be resumed 
with STEP2, the MERGl DD statement must be changed to refer to the 
generation data set by means of its present relative generation 
number, i.e., DSN=INV(0). 
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3. The following control statements illustrate the preparations that 
would be made for an automatic step or checkpoint restart or a 
deferred checkpoint restart before the job is submitted for the 
first time. 



//STMRG3 


JOB 


//STEPl 


EXEC 


//INPUT 


DD 


// 




//OUTPUT 


DD 


// 




//WORKl 


DD 


//W0RK2 


DD 


//CHKPT 


CD 


//STEP2 


EXEC 


//MERGl 


DD 


//MERG2 


DD 


// 




//RESULTS 


DD 


// 





54321, A. USER, >iSGLEVEL= (1,0) ,RD=R 

PGf^=SIMPSORT 

DSN=SORTIN,VCL=SER=100Ufa8,UNIT=2U00, X 

DI3P= (OLD, DELETE, KEEP) 

DSN=Ii:>lV( + l) ,UISlIT=2311,VOL=SER=55b33U, X 

SPACE=(:3200, (200,100)) ,DISP= (NEW, CATLG, KEEP) 

DS]Si=A, UNIT=24 00, DISP= (NEW, DELETE, CATLG) 

DSN=B , UNIT=2a 00 , DISP= ( WEW , DELETE , CATLG) 

DSM=C, UNIT=24 00, DISP=(iNlEW, DELETE, CATLG) 

PGM=MYMERGE 

DSN=INV(+1) ,DI3P=0LD 

DSN=M5,VOL=SER=(092501, 092502, 092b03) , X 

UlSiIT=(2400, 3) ,DISF=(CLD,KEEP) 

DSW=M6,UNIT=2U00,VOL=SER= (100101, 100102, X 

100103) ,DISP=(NEW, KEEP) 



Either an automatic checkpoint restart or a deferred checkpoint 
restart can occ\ir in STEPl if the step abnormally terminates. To 
perform, a deferred checkpoint restart, the RESTART parameter must 
be coded on the JOB statement and a SYSCHK DD statement must be 
included before resubmitting the job. Only automatic step restart 
can occur in STEP2. The data sets that would normally be defined 
as temporary have been defined as nontemporary data sets so 
conditional dispositions can be assigned to them. 
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Appendix C: Creating and Retrieving Indexed 
Sequential Data Sets 



Indexed sequential (ISAM) data sets are created and retrieved using 
special subsets of DD statement parameters and subpararreters. Each data 
set can occupy up to three different areas of space: 

1. Prime area — This area contains data and related track indexes. 

It exists for all indexed sequential data sets. 

2. Overflow area — This area contains overflow from the prime area 

when new data is added. It is optional. 

3. Index area — This area contains master and cylinder indexes 

associated with the data set. It exists for any 
indexed sequential data set that has a prime area 
occupying more than one cylinder. 

Indexed sequential data sets must reside on direct access volumes. The 
data set can reside on more than one volume and the device types of the 
volumes may in some cases differ. 



Creating an Indexed Sequential Data Set 

One to three DD statements can be used to define a new indexed 
sequential data set. When you use three DD statements to define the 
data set, each DD statement defines a different area and the areas must 
be defined in the following order: 

1. Index area. 

2. Prime area. 

3. Overflow area. 

Wnen you use two DD statements to define the data set, the areas must be 
defined in the following order: 

1. Index area. 1. Prime area. 

or 

2. Prime area. 2. Overflow area. 

When you use one CD statem.ent to define the data set, you are defining 
the prime area and, optionally, the index area. 

When more than one DD statement is used to define the data set, 
assign a ddname only to the first DD statement; the name field of the 
other statements must be blank. 

The only DD statement parameters that can be coded when defining a 
new indexed sequential data set are the DSNAMJfc, UNIT, VOLUME, LABEL, 
DCB, DISP, SPACE, SEP, and AFF parameters. When to code each of these 
parameters and what restrictions apply are described in the following 
paragraphs . 



Appendix 



Appendix C: Creating and Retrieving Indexed Sequential Data Sets 27 5 



THE DSNAME PARAMETER 

The DSNAME parameter is required on any DD statement that defines a new 
temporary or nonteniporary indexed sequential data set. To identify the 
area you are defining, you follow the DSNAME paraireter with the area: 
DSNAiyiE=name (INDEX) , DSNAME^nameCPRIMii) , or DSMAME^name (OVFLOW) . If you 
are using only one DD statement to define the data set, code 
DSNAME=name(ERIi^E) or DSi>iAJyiE=name. 

When reusing previously allocated space to create an ISAM data set, 
the DSNAME parameter must contain the name of the old aata set to be 
overlaid. 



TilE UNIT PARAMETER 

Tne UNIT parameter is required on any DD statement that defines a nev; 
indexed sequential data set unless VCLUME=REF-ref erence is coded. You 
must request a direct access device in the UNIT parameter and roust not 
request DEFER. 

If there are separate DD statements defining the prime and index 
areas, 370U must request the same number of direct access devices for the 
prim e area as there are volumes specified in the VOLUME paramteter. You 
may request only one direct access volume for an index area and one for 
an overflow area. 

A DD statement for the index area or overflow area can request a 
device type different than tne type requested on the other statemients. 

Another way to request a device is to code UNIT-AFf =ddnam.e; where the 
named DD statement requests the direct access device or device type you 
want . 



TiiE VOLUME PARAMETER 

Tne VOLUME parameter is required only if you want an area of the data 
set written on a specific volume or the prime area requires use of more 
than one volume. (If the prime area and index area are defined on the 
same statem.ent, you cannot request more than one volume on the DD 
statement.) Either supply the volume serial number or numibers in the 
VOLUME parameter or code VOLUME=REF=ref erence . In all cases, the VOLUiVjE 
parameter can be used to request a private volume (PRIVATE) and to 
retain the private volume (RETAIN) . 

The first volume to be allocated for the prime area of an indexed 
sequential data set cannot be the volume from which the system is loaded 
(the IPL volume) . 



ThE LABEL PARAMETER 

The LABEL parameter need only be coded to specify a retention period 
(EXPDT or RETPD) or password protection (PASSWORD) . 
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Tii£ DCE PARAMETER 

The DCB parameter itiust be coded on every DD sta-cement that defines an 
indexed sequential data set. At minimioiti, the DCB paraireter must contain 
DSORG-IS or DSORG=ISU. Other DCB subparameters can be coded to complete 
tne data control block if it has not Deen completed by the processing 
programi. When more than one DD statement is used to define the data 
set, code all the DCB subparameters on the first DD statement. Code 
DCjci=* . ddname on the remaining statement or statements; ddname is the 
name of the DD statement that contains the DCE subparameters. 

Wnen reusing previously allocated space and recreating an ISAi^^j data 
set, desired changes in the DCB parameter m.ust be coded on the DD 
statement. Although you are creating a new data set, some DCB 
subparameters cannot be changed if you want to use the space the old 
data set used. The DCB subparameters, you can change are: BFALiSI, 
BLKSIZE, CYLOFL, BSORG, BIARCHY, KEYLJiN, LRECL, NCP, NTM, OPTCD, RECFFi , 
and RKP. 



THE DISP PARAMETER 

If you are creating a new data set and not reusing preallocated space, 
the DISP parameter need only be coded if you want to keep, DISP=( ,KELP) , 
catalog, DISP= ( , CATLG) , or pass, DISP= ( ,PASS) , the data set. If you are 
reusing previously allocated space and recreating an ISAiy data set, code 
DISP=OLD and iMACRF=(PL) or (PM) . The newly created data set will 
overlay the old one. 

In order to catalog the data set when DISP=(,CATLG) is coded, the 
data set must be defined on only one DD statement. If the data set was 
defined on more than one DD statement and the volumes on which the data 
set now resides correspond to the samie device type, you can use the 
lEHPROGM utility program to catalog the data set. Refer to the chapter 
"The lEHPROGM Program" in the Utilities publication for details. 

Tri£ SPACE PARAMETER 

The SPACii paramieter is required on any DD statement that defines a new 
indexed sequential data set. Use either the recommended nonspecific 
allocation technique or the more restricted absolute track (AESTR) 
technique. If more than one DD statement is used to define the data 
set, all must request space using the sam.e technique. 

Nonspecific Allocation Technique 

You must request the primary quantity in cylinders (CYL) . When the DD 
statemient that defines the prime area requests miore than one volume, 
each volume is assigned the num.ber of cylinders requested in the SPACE 
parameter. 

One of the subparamieters of the SPACE param.eter, the "index" 
subparameter , is used to indicate how many cylinders are required for an 
index. When one DD statement is used to define the primie and index 
areas and you want to explicitly state the size of the index, code the 
"index" subparamieter . 

The CONTIG subparameter can be coded in the SPACE parameter, 
nowever , if CONTIG is coded on one of the statements, it must be coded 
on all of them. 

You cannot request a secondary quantity for an indexed sequential 
data set. Also, you cannot code the subparameters RLSE, MXIG, ALX, and 
ROUND. 
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Absolute Track Technique 

The nuirber of tracks you request must be equal to one or ir,ore whole 
cylinders. The address of the beginning track irust correspond with the 
first track of a cylinder other than the first cylinder on the voluire. 
When the DD statement that defines the prime area requests more than one 
volume, space is allocated for the prime area beginning at tne specified 
address and continuing through the voluire and onto the next volume until 
the request is satisfied. (This can only be done if the voluire table of 
contents of the second and all succeeding volumes is contained within 
the first cylinder of each volume.) 

One of the subparameters of the SPACE parameter, the "index" 
subparameter , is used to indicate how many tracks are required for an 
index. The number of tracks specified must be equal to one or more 
cylinders,. When one DD statement is used to define the prime and index 
areas and you want to explicitly state the size of the index, code the 
"index" subparameter . 



TtiE S£P OR AFF PARAMETER 

The SEP or AFF parameter is coded only if you want channel separation 
from the area or areas defined on the preceding statement or statements 
in the group. In order for the areas to be written using separate 
channels, you must also request devices by their actual address, e.g., 
UN1T=19 0,. 

Note: If the indexed sequential data set is to reside on more than one 
volume and an error is encountered as the volumes are being allocated to 
the data set, follow this procedure before resubmitting the jot: Use 
tlie lEbPROGM utility program to scratch the data set labels on any of 
the volumes to which the data set was successfully allocated. This 
utility program is described in the chapter "The lEHPROGw Program" in 
the Utilities publication. 



Area Arrangement of an Indexed Sequential Data Set 

when you create an indexed sequential data set , the arrangement of the 
areas is based on two criteria: 

1. The number of DD statements used to define the data set. 

2. What area each DD statement defines. 

An additional criterion is used when you do not include a DD statement 
that defines the index area: 

3. Is an index size coded in the SPACE parameter of the DD statement 
that defines the prime area? 

Table 3 illustrates the different arrangements that can result based 
on the criteria listed above. In addition. Table 3 indicates what 
restrictions apply on the number and types of devices that can be 
requested. 
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Table 3. Area Arrangeirient of Indexed Sequential Data Sets 

r r T— 



CRITERIA 



I" 



"! 






1. Number of 
DD 
Statements 



2. Area defined 
on a DD 
statement 



INDEX 
PRII^iE 
OVFLOW 



INDEX 
PRIME 



PRIME 
OVFLOW 



PRIME 
OVFLOW 



PRIME 



PRIME 



3. Index 
size 
coded? 



No 



Yes 



No 



Yes 



RESTi^ICTIONS Oi>l 
DEVICE TYPES AND 
NUMBER OF DEVICES 
x<EQUiiSTED. 



--1- 



None 



None 



None 



Tbe statement 
defining the 
prime area cannot 
request more than 
one device. 



None 



Cannot request 
more than one 
device. 



RESULTING 
ARRANGEMENT 
OF 

AREAS 



Separate 
index, prime, 
and overflov? 
areas . 



Separate 
index and 
prime 
areas. ^ 



Separate 
prime and 
overflow 
areas . An 
index area is 
at the end of 
the overflow 
area . 



Separate 
prime and 
overflow 
areas. An 
index area is 
embedded in 
the prime 
area . 



Prime area 
with index 
area at its 
end. 2 



Prime area 
with embedded 
index area. 



^If both areas are on volumes that correspond to the same device 
type, an overflow area is €;stablished if cne of the cylinders 
allocated for the index area is only partially used. The overflow 
area is established in the unused portion of that cylinder. 

^If the unused portion of the index area is less than one cylinder, 
it is used as an overflow cirea. 
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Retrieving an Indexed Sequential Data Set 

If all areas of an existing indexed sequential data set reside on 
volumes of the same device type, you can retrieve the entire data set 
with one DD statement. If the index or overflow resides on a voluirie of 
a different device type, you must use two DD statements. If the index 
and overflow reside on volumes of different device types, you must use 
tnree DD statements to retrieve the data set. 

The only DD statement parameters that can te coded when retrieving an 
indexed sequential data set are the DSNAME, 'QUIT, VOLUJ^iE, DCB, and DISP 
parameters. When to code each of these parameters and what restrictions 
<ipply 3i"e described in the following paragraphs. 

'Um DSUhM^ PARAMETER 

Tiie DtjNAME parameter is always required. Identify the data set by its 
name, but do not include the term, INLEX, PFIiy;}- , or OVFLOW. If the data 
set was passed from a previous step, identify it oy a backward 
reference. 



Tilt. Ui^IT PARAMETER 

The UMIT parameter must be coded unless tne data set resides on one 
volume and was passed. You identify in the UMIT parameter the device 
type and how many of these devices are required. 

If the data set resides on more than one volume and the volumes 
correspond to the same device type, you need only one ED statement to 
retrieve the data set. Request one device in the UNIT parameter per 
volume. If the index or overflow area of the data set resides on a 
different type of volume than the other areas, you must use two DD 
statements to retrieve the data set. On one DD statemient, request tne 
device type required to retrieve the index or overflow area. On the 
otner DD statement, request the device type and tne number of devices 
required to retrieve the prime area and the overflow area if the 
overflow area resides on the same device type. If the index and the 
overflow areas reside on different device types from the prime area, a 
third DD statemient is needed. 



THE VOLUME PARAMETER 

Tne VOLUME parameter must be coded unless the data set resides on one 
volume and was passed from a previous step. Identify in the VOLUME 
paramieter the serial numibers of the volum;es en which the data set 
resides. Code the serial numbers in the same order as tney were coded 
on the DD statements used to create the data set. 



TiiE DCB PARAMETER 

The DCB parameter must be coded unless the data set was passed from a 
previous step. The DCB param.eter must always contain DSCRG=Id or 
DSORG=ISU.. Other DCB subparamieters can be coded to complete the data 
control block if it has not Deen completed by the processing program. 

THE DI6P PARAMETER 

Tiie DISP parameter must always be coded. The first subparameter of the 
DISP parameter must be MOD or OLD. You can, optionally, assign a 
disposition as tne second subparameter. 
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Example of Creating and Retrieving an Indexed Sequential Data Set 

1. The following job step includes the DD statements that could be 
used to create an indexed sequential data set. i^ach area of the 
indexed sequential data set is defined on a separate DD statement. 

//0UTPUT4 EXEC PGM=INCLUDE 

//GROUPl DD DSNAME=PART8 6 ( INDEX) ,DISP^(, KEEP) ,ulS.IT=2301, X 

// VOLUiyiE=SER=538762,SPAC£=(CYL,10, ,CONTIG) , X 

// DCB= ( D30RG=IS , RECFM=F , LRECL= 8 , RKP=1 , KEYLEN= 8 ) 

// DD DSNAME^PART86 (PRIME) ,DISP=(, KEEP) ,UISiI'r=(2311, 2) , X 

// VOLUME=SEK=( 538763, 538764), X 

// SPACE=(CYL, (25) , ,CONTIG) ,DCB=* . GROUPl 

// DD DSNAME=PART86(OVFLOW),DISP=(,KEEP) ,U1S1IT=2311, X 

// VOLUME=SER=538765,SPACE=(CYL,15, ,CCl?TIG) , X 

// DCB=*. GROUPl 

The following job step includes the DD statements required to 
retrieve the indexed sequential data set created above. 

//INPUT12 LXEC PGM=ADD 

//RET4 DD DSNAME=PART86,DCB=DSORG=IS,UNIT=2301, X 

// DISP=OLD,VOLUME=SER=538762 

// DD DSNAME=--PART86,DCB=DSORG=IS,UNIT={2311,3) , X 

// DISP=OLD,VOLUiyJE=SER= (538763, 538764, 838765) 

Two DD statements are required to retrieve the data set because the 
index area resides on a volume of a different device type than the 
volumes on which the prime and overflow areas reside. 
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Appendix D: Creating and Retrieving 
Generation Data Sets 



A generation data set is one of a collection of successive, historically 
related, cataloged data sets known as a generation data group. The 
system keeps track of each data set in a generation data group as it is 
created so that new data sets can be chronologically ordered and old 
ones easily retrieved. 

To create or retrieve a generation data set, you identify the 
generation data group name in the DSNAME parameter and follow the group 
name with a relative generation number. When creating a generation data 
set, the relative generation number tells the system whether this is the 
first data set being added during the job, the second, the third, etc. 
When retrieving a generation data set, the relative generation number 
tells the system how many data sets have been added to the group since 
this data set was added. 

A generation data group can consist of cataloged sequential, 
partitioned, indexed sequential (if the data set is defined on one Djj 
statement), and direct data sets residing on tape volumes, direct access 
volumes, or both. Generation data sets can have like or unlike DCE 
attributes and data set organizations. If the attributes and 
organizations of all generations in a group are identical, the 
generations can be retrieved together as a single data set (up to 255 
data sets can be retrieved in this way) , 

Before You Define the First Generation Data Set 

Before you define the first generation data set, you must build a 
generation data group index. This index provides lower-level entries 
for as many generation data sets (up to 2 55) as you would like to have 
in your generation data group. The system uses these lower-level 
indexes to keep track of the chronological order of the generation data 
sets. The index must reside on the system residence volume, or an 
alternate control volume. You use the lEHPRCGiy! utility program to build 
your index; this program is described in the chapter "The lEHPlROGM 
Program" in the Utilities publication. 

Another requirement of generation data groups is that a data set 
label must exist on the samie volume as the index. The system uses this 
label to refer to DCB attributes when you define a new generation data 
set. There are two ways to satisfy this requirement: (1) create a 
miodel data set label before you define the first generation data set; or 
(2) use the DCB parameter to refer the system to an existing cataloged 
data set each time you define a new generation data set. 

Creating a Model Data Set Label 

To create a model data set label, you must define a data set and request 
that it be placed on the same volume as the generation data group index. 
This ensures that there is always a data set label on the same volume as 
the index to which the system; can refer. 

The name you assign to the data set may be the same or different than 
the name assigned to the generation data group. (If you assign the same 
name for both, the data set associated with the model data set label 
cannot be cataloged.) You miay request a space allocation of zero tracks 
or cylinders. The DCB attributes you can supply are D30RG, OPTCD, 
BLKSIZE, LRECL, KEYLEN, and RKP. 
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This is an example of creating a ncdel data set label: 

//DDl DD DSNAME=PAY.WEEK,DISt=(WEW,KEiiP) ,UNI1 = 2311, X 

// VOLUME=3ER=SYSRES,SPACE=(TKK,0) ,DCB=(RECFf.=FB, X 

// LRECL=240,BLKSIZE=9bO) 

You need not create a model data set label for every generation data 
group whose indexes reside on the sane voluire. Instead, you may create 
one iTiodel data set label to be used by any numDer of generation data 
groups. If you create only one model, you should not supply any DCB 
attributes. V^hen you create a generation data set, you specify the name 
of the model in the DCB parameter and follow the nam.e with a list of all 
the DCB subparameters required for the new generation data set, i.e., 
DCB= (dsnamie, list of attributes). 

Referrin g the System to a Cataloged Data set 

If there is a cataloged data set that resides on the same volume as your 
generation data group index and you are sure that data set will exist as 
long as you are adding data sets to your generation data group, you need 
not create a model data set label. When you create a generation data 
set, you specify the name of the cataloged data set in the DCB 
parameter, i.e., DCB=dsnanie. If all the DCB attributes are not 
containeid in the label of the cataloged data set, or if you want to 
override certain attributes, follow the data set name with these 
attributes, i.e., DCB=(dsname, list of attributes) - 



Creating a Generation Data Set 

when defining a new generation data set, you always code the DSNAME, 
DISP, and UNIT parameters. Other paramieters you might code are the 
VOLUME, SPACE, LABEL, and DCB parameters. 

THE DSNAME PARAMETER 

In the DSNAME parameter, you code the name of the generation data group 
followed by a number enclosed in parentheses. This number must be 1 or 
greater. If this is the first data set you are adding to a particular 
generation data group during the job, code +1 in parentheses. Each timie 
during the job you add a data set to the same generation data group, 
increase the number by one. 

Any time you refer to this data set later in the job, you use the 
same relative generation number as was used earlier. At the end of the 
job, the system updates the relative generation numbers of all 
generations in the group to reflect the additions. 

TnE DISP PARAMETER 

iJew genejrations are assigned a status of NEPv and a disposition of CATLG 
in the DISP parameter, i.e., DISP= (NEW, CATLG) . If the disposition is 
not specified in the DISP parameter, the system assumes a disposition of 
CATLG . 
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THE UNIT PAEAMETER 

The UNIT parameter is required on an;y DD stateirent that defines a new 
generation data set unless VOLUME=REF=ref erence is coded. In the UNxT 
parameter, you identify the type and numi^er of devices ycu want (tape or 
direct access). 

Another way to request a device is to code UNIT-AIT =ddname; where the 
named DD statement requests the device or device type you want. 

THE VOLUiME PARAMETER 

You may assign a volume in the VOLUME parameter or let the system assign 
one for you. The VOLUME parameter can also be used to request a private 
volume (PRIVATE), to retain the private volume (RETAIi^) , and to indicate 
that more volumes may be required (volume count) . 

THE SPACE PARAMETER 

The SPACE parameter is coded only when the generation data set is to 
reside on a direct access volume. The SPLIT or SUBALLOC parameter can 
be coded in place of the SPACE parameter if the data set's organization 
permits the use of these parameters . 

THE LABEL PARAMETER 

You can specify label type, password protection (PASSWCRU) , and a 
retention period (EXPDT or RETPD) in the LAEEL parameter. If the data 
set will reside on a tape volume and is not the first data set on the 
volume, specify a data set se^quence nuniber. 

THE DCB PARAMETER 

A model data set label that has the same namie as the group name may 
exist. If this is so, and if the label contains all the attributes 
required to define this generation, you need not code the DCB parametei . 
If all the attributes are not contained in the label, or if you want to 
override certain attributes, code these attributes in the DCB parameter, 
i.e., DCB=(list of attributes). 

If a model data set label has a different name than the group name 
and if the label contains all the attributes required to define this 
generation data set, only the name of the data set associated with the 
model data set label need be coded. Code the name in the DCB pararreter, 
i.e., DCB=dsname. If all the attributes are not contained in the label, 
or if you want to override c€;rtain attributes, follow the aata set name 
with these attributes, i.e., DCB- (dsname, list of attributes). 

If a model data set label does not exist, you must code the name of a 
cataloged data set that resides on the same voluiiie as the generation 
data group index, i.e., DCB=dsname. If all tne attributes are not 
contained in the label for this data set, or if you want to override 
certain attributes, follow the data set name with these attributes, 
i.e., DCB= (dsname, list of attributes). 
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Retrieving a Generation Data Set 

To retrieve a generation data set, you always code the DSNi^ME and DISP 
parameters. Other parameters you might code are the UNIT, LABEL, and 
DCB parameters. 

TllJ^ DSNAiME PARAMETER 

In the DoNAME parameter, you code the name of the generation data group 
followed jDy a number enclosed in parentheses. Tne nunfcer you code 
depends on how many new generation data sets have been added to the 
qroup since this generation data set was added. If none have been added 
prior to the job, code a zero (0). If one has been added prior to the 
job, code (-1) . Decrement the number by 1 until you determine the 
present relative generation number of the data set, then code this 
number. 

Any time you refer to this data set later in the job, you use the 
sam:e relative generation number as was used earlier, even if another 
generation has been added during the job. 

If you want to retrieve all generations ol a generation data group as 
a single data set, you specify the generation data group namie without a 
generation number, e.g., DSNAKJi=WEEKLY. PAYRCLL. You can retrieve all 
generations as a single data set only if the attributes and 
organizations of all generations are identical. 

TxiL iJiSP PARAMETER 

Tne DISP parameter must always be coded. The first subparameter of the 
JISP param.eter must oe OLD, SHR, or iXlOD. You can, optionally, assign a 
disposition as the second subparam.eter . 

'iiiit. UNIT PARAMETER 

Code the UNIT parameter when you want more than one device assigned to 
the aata set. Code the number of devices you want in the unit count 
suDparameter , or, if the data set resides on more than one volume and 
you want as many devices as there are volumes, code P in place of the 
unit count subparam.eter. 

Til a LABEL PARAMETER 

Code the LABEL parameter when the data set has other than standard 
labels . 



TrlE DCB PARAKl^TER 

CoGe the DCB parameter when the data set has other than standard labels 
and DCB information is reguired to complete the data control block. 



Resubmitting a Job for Restart 

Certain rules apply when you refer to generation data sets in a job 
resubmitted for restart (the RESTART parameter is coded on the JOB 
statemient) . 
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for step restart ; If step restart is perforired, generation data sets 
that ^fwere created and catalogeid in steps preceding the restart step rrust 
not be referred to in the restart step or in steps following the restart 
step oy means of the same relcitive generation numbers that v/ere used to 
create them. Instead, you must refer to a generation data set by means 
ol its present relative generation number. For example, if the last 
generation data set created and cataloged was assigned a generation 
number of +2, it would be refe^rred to as in the restart step and in 
oteps following the restart step. In this case, the generation data set 
assigned a generation number of +1 would be referred to as -1. 

For checkpoint re st art ; If generation data sets created in the restart 
step were kept instead of cataloged (i.e., D1SP= (NEW, CATLG, KEEP) was 
coded) , you can, during checkpoint restart, refer to these data sets and 
generation data sets created and cataloged in steps preceding the 
restart step by means of the same relative generation numbers that were 
used to create them. 



Reference 



Generation data sets can be created and retrieved using utility 
programs. How to do this is described in "Appendix E: Generation 
Data Groups" in the Utilities publication. Also described in this 
appendix is how to put indexed sequential data sets in a generation 
data group . 



Example o£ Creating and Retrieving Generation Data Sets 



1. The following job step includes the DD statements that could be 

used to add three data sets to a generation data group. 

//STEPA EXEC PGM=PROCj^iSS 



DD 



DD 



//DDl 

// 

//DD2 

// 

//DD3 DD 

// 

// 



DSNA]yiE=A.B.C(+l) ,DISP=(NEW,CATLG) , U1N)IT=2400 , X 

V0L=SER=1 3 8 U 6 , LABEL= ( , SUL) 

DSNAME=A.B.C(+2) ,DISP= (OLD, CATLG) ,UNIT=2 311, X 

VOL=SER=10311 

DSNAME=A.B.C( + 3) ,DISP= (WSW , CATLG) , Ul:>iIT=2 301, X 

VOL=SER=28 929,SPACE=(480, (150,20)) ,DCE= (LRECL=120 , X 

BLKSIZE=U80) 



The first two DD statements do not include the DCB parameter; 
therefore, a model data set label must exist on the same volume as 
the generation data group index and must have the same name as the 
generation data group (A.B.C). Since the DCB parameter is coded 
on the third DD statement, the attributes LJRECL and ELKSIZE, along 
with the attributes included in the model data set label, are 
used. 

The following job includes the DD statements required to retrieve 
the generation data sets defined above when no other data sets 
have been added to the generation data group. 

//JWC JOB CLASS=B 

//STEPl EXEC PGK=REP0RT9 

//DDA DD DSNAME=A.B.C(-2) ,DISP=OLD,LABEL=(,SUL) 

//DDB DD DSNAME=A.B.C(-1),DISP=0LD 

//DDC DD DSNAME=A.B.C(0) ,DISP=OLD 
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Appendix E: Default Parameter Values 
Supplied in the Input Reader Procedure 



As your control statements are read and interpreted in systems with MFT 
and MVT, the input reader assigns default values to specific parameters 
that are not coded and checks for violations of certain restrictions. 
The default values for specific paraireters and the restrictions are 
specified in the cataloged procedure for the input reader. 

The input reader is controlled by a reader/interpreter cataloged 
procedure supplied by IBM or the installation. The default parameter 
values and restrictions will probably differ in the IBM-supplied and the 
installation- supplied procedures. 



How to Keep Track o£ the Default Values and Restrictions 

Table 4 lists the parameters for which default values are assigned when 
they are not coded on specific control statements. The default values 
assigned to these parameters when an IBM-supplied cataloged procedure is 
used are also listed. Space is left in the right-hand portion of the 
table so you can write in tne default values that will be assigned when 
an installation-supplied procedure is used. Table 4 also lists those 
restrictions that must be checked as the control statements are read and 
tells which apply when an IBM-supplied procedure is used. Space is left 
in the right-hand portion of the table so you can write in which of 
these restrictions apply when a installation-supplied procedure is used. 

The page on which Table 4 appears may be removed from the publication 
and placed in a convenient location, so that you and other programmers 
can refer to it. 
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Table 4. Default Values and restrictions Supplied in the Input Reader 
Procedures 



Default Pararreter Values 









1 


1 


1 Installation-Supplied 


Parameter 






1 ^1-?5'i-p»Tn^r^'*~ * T PV — Q-Ti^T-t1 -1 cir\ 


L 








1 


1 


r 

j Uame : 


"T 

1 Name : 







— 


+ 


1 


+ 


-+ 


iyiSGLEVEL 






1 JOB 


|(0,1) 






PRTY 






1 JOB 


ll 






x^EGION 






|JOB and 


EXECj 5 OK 






TIME 






jEXEC 


130 irinutes 






ROLL 






|JOB and 


EXEC| (YES, NO) 






UNIT (note 


2) 




|DD 


ISYSDA 






SPACE (note 


2) 




]DD 


1 (TkK, (bO,10)) 






BLKSIZE (note 


3) 


|DD 


1 (note 1) 






BUFNO (note 


3) 




|DD 


1 (note 1) 







Restrictions 

■T T- 



T 

I I I Installation-Supplied 

Parameter or (Statement | IBM-Supplied j- ^ 

Subparameter j j JMaire: jlMame: 



Accounting 
Information 

Programmer' s 
Name 

BLP (note U) 



■+■ 



I JOB 

I 

I JOB 
|DD 
-X 



j not required j 

I I 

I not required j 

|NL assumed | 

-X X. 



Notes : 

1. The default value differs in each of the three lEk-supplied 
procedures, as follows: 



Procedure Name 



KDR 



T- T- 

I RDR400 I 



RDR3200 



BLKSIZE 
BUFNO 



80 
2 



400 
2 



3200 
1 



2. 



H. 



The default values for the UNIT and SPACE parameters are used when 
you do not include these parameters on a DC statement that defines 
a data set Jceing routed through an output stream (i.e., the SYSOUT 
parameter is coded on th€J DD statement) . 

The default values for the DCB subparameters BLKSiZ^' and BUi-ixO are 
used when you do not include these subparameters on a DD statement 
that defines data in the input stream (i.e., DD * or DD DATA 
statement) . 

BLP is a subparameter in the LABEL parameter that requests tnat 
tape label processing be bypassed. 
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Appendix F: A Checklist 



When you create or retrieve a data set^ the system requires certain 
information. This information is supplied on the DD statement that 
defines the data set. 

This appendix can be used as a checklist: As you code your DD 
statements, find the function you are performing in the left-hand column 
of Table 5. Across from the function are two separate lists of 
parameters. These parameters describe the information that you must 
supply to the system and the information that you may have to supply. 
You can compare your DD statement with what is listed to make sure all 
the required information is available to the system. 

Following Table 5 are examples of the DD statements that might be 
used when performing functions described in the table. Each example is 
keyed by number to a particular block within the table. If you do not 
understand why a parameter is listed for the function, either look at 
the example that corresponds to the number within the block or refer to 
the parameter description in 5>ection IV of this publication. 



Table 
r 



A Checklist (Part 1 of 3) 



FUNCTION: 

Creating a Data Set 



■T 

I 

j Information That Is 
i Always Required 

.X . 



-T 1 

J Information 
I That May 
jBe Required 



Temporary Data Sets 



Creating a Data Set 

on a Unit Record Device 



UNIT 






Creatxng a Data Set on 
a Tape Volume 



UNIT 



I DCB © 

I ucs 

© I DCB 

I VOLUME 

I LABEL 



Creating a Data Set in 
the Output Stream for 
PCP Systems 

Creating a Data Set in 
the Output Stream for 
MFT or MVT Systems 

Creating A Data Set 
on a Direct Access 
Volume 



SYSOUT 



SYSOUT 



UNIT 
SPACE 



©I DCB 



01 DCB © 

I UNIT 

j SPACE 

© I DCB @ 

i VOLUME 

I LABEL 



Nontemporary Data Sets 



Creating a Data Set 
on a Tape Volume 



UNIT 

DSNAME 

DISP 



® 



ii)| LABEL (12; 
DCB 
VOLUME 



1— — 




-: ^ 





-r+- 





1 


Creating a Generation 


1 


DISP 


@l 


DCB @ 


1 


Data Set on a Tape 


1 


UNIT 


1 


LABEL 


1 


Volume 


1 


DSNAME 


1 


VOLUME 










- _ J. 
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Table 5. 

r •■ 



A Checklist (Part 2 of 3) 






Creating a Nontemporary 
Data Set (con't) 



Creating a Sequential 

Data Set on a Direct Access 

Volume (BSAM or QSAM) 



+- 



Information That Is 
Always Required 



UNIT (15) 

DSNAME 
DISP 
SPACE , SPLIT , orSUBALLOC 



T 1 

Information 
That May 
Be Required 

LABEL (je^ 

DCB 

VOLUME 



+-- 



Creating a Data Set With 
Direct Organization on a 
Direct Access Volume (BD/y^) 



UNIT 
DSNAME 
DISP 
SPACE or SUBALLOC 
DCB 



17 



LABEL (ui) 
VOLUME 



Creating a Partitioned 
Data Set on a Direct Access 
Volume ( BPAM) 



UNIT 
DSNAME 
DISP 
SPACE or SUBALLOC 



LABEL (2C)) 

VOLUME 

DCB 



Creating a New Member 
for a Partitioned Data 
Set 



DISP 
DSNAME 



21 



UNIT (2^ 
VOLUME 



Creating a Data Set With 
Indexed Sequential Organi- 
zation on a Direct Access 
Volume (QISAM) 



UNIT 

DSNAME 

DISP 

DCB 

SPACE 



23 



VOLUME @ 
LABEL 



Creating a Generation 
Data Set on a Direct 
Access Volume 



SPACE 
DISP 
UNIT 
DSNAME 



Retrieving a Noncataloged 
Data Set on a Tape 
Volume 



DSNAME 
UNIT 
VOLUME 
DISP 



Retrieving a Noncataloged 
Sequential Data Set on a 
Direct Access Volume 
(BSAM or QSAM) 






UNIT 
VOLUME 
DSNAME 
DISP 



25 



DCB 

LABEL 

VOLUME 



2K 



FUNCTION: 

Retrieving a Data Set 


X -_ 




L_ 






Retrieving a Cataloged 
Data Set 


1 
1 

1 


DSNAME 
DISP 


1 
— ~+- 


DCB 

LABEL 

UNIT 


@ 



H 



H 



H 



(29) I LABEL (3()) 
I DCB 
I 



(3i) I LABEL (3^ 



+ H 

(33) I LABEL (s^r 



Retrieving a Noncataloged 
Data Set with Direct 
Organization on a Direct 
Access Volume (BDAM) 



UNIT 
VOLUME 
DSNAME 
DISP 



Retrieving a Member of 


1 


DISP 


@ 1 UNIT @ 


a Partitioned Data Set 


1 


DSNAME 


1 VOLUME 


(BPAM) 


1 




1 











(Part 2 of 3) 
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Table 5. A Checklist (Part 3 of 3) 

r r- 



Retrieving a Data set 



Information That Is 
Always Required 



I Information 
I That May 
j Be Required 



Retrieving a Data Set 
With Indexed Sequential 
Organization on a Direct 
Access Volume (QISAM or 
BISAM) 



DSNAME 

UNIT 

VOLUME 

DCB 

DISP 



Retrieving a Passed 
Data Set 



DSNAME 
DISP 



38 



LABEL 
DCB 

VOLUME 
UNIT 



39 



Retrieving a Generation 
Data Set 



DSNAME 
DISP 



(45) I DCB ® 

1 LABEL 
I UNIT 

J. 



Examples 

© //DDA 
© //DDB 

© //DDC 
© //DDD 



DD UNIT=iaOU 

DD UNIT=1403, UCS=PCAN,DCB=PRTSP=2 

DD UNIT=2400 

DD UNIT=2400-l,DCB=DEN=l,VOLUME=SER=im87,LABEL=2 



© //DDE DD SYSOUT=L 

® //DDF DD SYS0UT=G,DCB=PRTSP=2 

© //DDG DD SYSOUT=(M, ,7956) 

© //DDH DD SYSOUT=B,UNIT=2301,SPACE=(80,300) ,DCB=BLKSIZE=640 

© //DDI DD UNIT=SYSDA,SPACE=(TRK, (20,5)) 

@ //DDJ DD UNIT=2311,SPACE=(CYL, (2,1)) ,DCB=(RECFM=S,LRECL=X) , 
// LABEL= ( , SUL) , V0LUME=SER=19 0853 

® //DDK DD UNIT-=2400,DSNAME=OUT,DISP=(NEW,KEEP) 

@ //DDL DD UNIT=2400-2,DSNAME=WLK18,DISP=(,KEEP) ,LABEL=(,NL) , 
// DCB=TRTCH=C,VOLUME=SER=1540 

@ //DDM DD DISP=(,CATLG),UNIT=2400,DSNAME=WEEK.PAY(+1) 

@ //DDN DD DISP=(,CATLG),UNIT=2400-1,DSN=YEAR.MON(+1), 
// LABEL= ( , SUL) , DCB=A. B. C, V0LUME=SER=GDG18 



X 
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^ 
R) 



//DDO 

//DDP 

// 

// 



DD 



UNIT=2311, DSNAME=LNG, DISP= ( ,KEEP) ,SPACE= (TRK, (12 , 2) ) 



DD UNIT=2314,DSNAME=CLB,DISP=(,CATLG), X 

SPACE= ( 1024, ( 100, 25) ) , LABEL= ( , SUL, ,EXPDT=70180) , X 
VOL=SER=S12148,DCB=(BLKSIZE=2UO,RECFM=FB,LRECL=60) 



@ //DDQ DD UNIT=2311, DSNAME=JCD,DISP=( NEW, KEEP) , 
// SPACE= (CYL, (8,1)), DCB=DSORG=DA 

@ //DDR DD UNIT=2302,DSN=MT12,DISP=(,PASS), 

// SPACE= (1024, ( 200, 10) ) ,DCB= (DSORG=DA,BLKSIZE=200 , 

// KEYLEN=4,RECFM=F) ,LABEL=(,SUL) ,VOLUME=SER=49878 



@ //DDS DD UNIT=2302,DSNAME=PDS14,DISP=(NEW,KEEP) , 
// SUBALLOC=(CYL, (20, 1, 3) , STEPl. DDl) 

(g) //DDT DD UNIT=2314,DSNAME=AHTRY,DISP=(,CATLG) , 
// SPACE= (CYL, (8,2,2)), LABEL= ( , , PASSWORD) , 

// VOLUME=SER=158U91,DCB=(RECFM=F,LRECL=8 0) 



(tv) //DDU DD DSNAME=AHTRY(SET4),DISP=0LD 

@ //DDV DD UNIT=2302,VOLUME=SER=X13912,DISP=OLD, 
// DSNAME= SHTR ( MEMB 2 ) 



23 



24 



//DDW 
// 

//DDX 

// 

// 

// 

// 

// 



DD UNIT=2311,DSNAME=DAT (PRIME) ,DISP= (NEW, KEEP) , 
DCB=DSORG=IS,SPACE=(CYL, (5,,1)) 



DD 



DD 



UNIT=2302,DSN=ISQ (PRIME) ,DISP=(,KEEP) ,DCB= (DSORG=IS , 
BLKSIZE=2U0 , CYL0FL=1 , OPTCD=MYLR , RECFM=FB , LRECL=60 , 
RKP=19 , KEYLEN=10) , SPACE= (CYL, 2) , VOL=SER=535861 , 
LABEL=EXPDT=70301 

UNIT=2302,DSN=ISQ(OVFLOW) ,DISP= ( ,KEEP) ,DCB=*.DDX, 
SPACE= (CYL, 1) ,VOL=SER=538267,LABEL=EXPDT=70301 



(25) //DDY DD DSNAME=PAY.WEEK(+1),DISP=(,CATLG),UNIT=2314, 
// SPACE= (TRK, (3,2)) 

@ //DDZ DD DSN=INV.FORM8(+2),DISP=(,CATLG) ,UNIT=2311, 

// VOLUME=SER=SA2103, LABEL= ( , SUL) ,DC3= (MODEL2,RECFM=F, 

// LRECL=80),SPACE=(CYL, (2,1)) 



@ //DDl DD DSNAME=A.B,C,DISP=OLD 



(28) //DD2 DD DSN=KELL12,DISP=0LD,LABEL=(,NSL),UNIT=(,P) , X 

// DCB=(BUFNO=U,HIARCHY=l) 

@ //DBS DD DSNAME=FILE18,UNIT=2a00,DISP=OLD,VOL=SER=96977 

(g) //DD4 DD DSNAME=MILS, UNIT=2400-2,DISP= (OLD, PASS) ,VOL=SER=9818, X 
// LABEL=(,NSL) ,DCB=(BLKSIZE=1600,LRECL=80) 



@ //DD5 DD DSNAM£=GLOSS,DISP=OLD,UNIT=2311,VOLUME=SER=Pl4992 

(32) //DD6 DD DSNAME=LAB14,UNIT=2301,DISP=OLD,VOLUME=SER=H69568, 
// LABEL= ( , SUL, , IN) 
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@ //DD7 DD DSNAME=SERNOS,DISP=OLD,UNIT=2311,VOLUME=SER=X20 

@ //DD8 DD DSN=BOLS,DISP=OLD,VOLUME=SER=W5898,UNIT=2302, X 

// LABEL=(,SIIL) 

(35) //DD9 DD DSN=PGM(A81),DISP=0LD 

@ //DDIO DD DSNAME=LIBS(PROJ6),UNIT=2301,DISP=OLD,VOL=SER=D4762 

@ //DDl DD DSNAME=IND31,UNIT=(2311,2),DISP=OLD,VOLUME=SER(C2021, X 
// C2022) ,DCB=DSORG=IS 

(g) //DD12 DD DSNAME=CHAN,DISP=( OLD, KEEP) 

@ //DD13 DD DSNAME=* . STEPl. CREATE, DISP= ( OLD , DELETE) , LABEL= ( , NL) , X 
// UNIT= ( , 2) , VOLUME= ( PRIVATE , , U ) , DCB=* . STEPl . CREATE 

@ //DDIU DD DSNAME=PAY.WEEK(-3) ,DISP=OLD 

@ //DD15 DD DSN=INV. FORMS ( 0), DISP=OLD, LABEL= (, SUL) ,UNIT=(,P) , X 
// DCB=(BLKSIZE=2aO,RECFM=FB,LRECL=60) 
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Section XI: Glossary 



* parameter ; This parameter is coded as 
the first parameter on a DD statement that 
precedes data in the input stream. 



ACCT parameter ; This parameter is used to 
supply accounting information for a job 
step to an installation accounting routine 
and is coded on an EXEC statement. 

AFF parameter ; This parameter is used to 
request the same channel separation from 
certain data sets as was requested earlier 
in the job step. The AFF parameter is 
coded on a DD statement. 

alias ; An alternate name that may be used 
to refer to a member of a partitioned data 
set. 

allocation ; The process of assigning a 
resource to a job step. 

automatic restart ; A restart of a job 
after a job step abnormally terminates. 
The restart takes place during the current 
run, that is, without resubmitting the job. 

automatic volume recognition (AVR) ; A 
feature that allows the operator to mount 
labeled volumes on available input/output 
devices before those volumes are required 
by a job step. 

auxiliary storage ; Data storage other than 
main storage; secondary storage. 



backward reference ; A facility of the job 
control language that permits you to copy 
information or refer to DD statements that 
appear earlier in the job. 

catalog ; 

1. The collection of all data set indexes 
maintained by data management. Each 
entry contains a data set name and 
volume and unit information about the 
data set . 

2 . To place an entry for a data set in 
the catalog. To specify this on a 
control statement, code 

DISP=( status, CATLG) on the DD 
statement that defines the data set 
you want cataloged. A cataloged data 
set is easy to retrieve. 

cataloged data set ; A data set that is 
represented in an index or hierarchy of 
indexes in the system catalog, the indexes 
provide the means for locating the data 
set. 



cataloged procedure ; A set of job control 
statements that has been assigned a name 
and placed in a partitioned data set known 
as the procedure library. To use a 
cataloged procedure, code the procedure 
name on an EXEC statement. 



checkpoint/restart ; A facility of the 
operating system that can minimize time 
lost in reprocessing a job step that 
abnormally terminated. The CHKPT macro 
instruction, the RESTART parameter en the 
JOB statement, and the RD parameter on the 
JOB or EXEC statement are associated with 
this facility. 

cneckpoint restart ; A restart within a job 
stepo The restart may be automatic 
(depending on an eligible completion code 
and the operator's consent) or deferred, 
where deferred involves resubmitting the 
job and coding the RESTART parameter on the 
JOB statement of the resubmitted job. 

CLASS parameter ; This parameter is used to 
assign a job class to your job and is coded 
on a JOB statement. In multiprogramming 
systems, jobs within a job class are 
initiated according to their priority 
numbers. 

command statement ; A job statement that is 
used to issue commands to the system 
through the input stream. 

comment statement ; A job control statement 
used to contain information that may be 
helpful to yourself or another person that 
may be running your job or reviewing your 
output listing. 

concatenated data sets ; A group of input 
data sets that are treated as one data set 
for the duration of a job step. 

COND parameter ; This parameter is used to 
test return codes issued by the processing" 
programs; any test that is satisfied causes 
the job to be terminated or a job step to 
be bypassed. The COND parameter is coded 
on a JOB or EXEC statement. 

control volume ; A volume that contains one 
or more indexes of the catalog. 



data control block (DCB) ; A control block 
used to contain certain attributes required 
by an access method to store or retrieve a 
data set. The DCB parameter is one means 
of supplying attributes. 
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DATA paraiTieter ; This parameter is coded as 
the first parameter on a DD statement that 
precedes data in the input stream when the 
data contains job control statements. 

data set t An organized collection of 
related data in one of several prescribed 
arrangements. The information required to 
store and retrieve this data is defined on 
a DD statement. 



according to its actual address or its 
address relative to the beginning of the 
data set- 



directory ; A series of 256-byte records at 
the beginning of a partitioned data set 
that contains an entry for each member in 
the data set. 



data set c ontrol block ; A data set label 
for a data set on a direct access volume. 

data set label ; A collection of 
information that describes the attributes 
of a data set. The data set label for a 
data set is normally on the same voliane as 
the data set it describes. 



DISP parameter : This parameter is used to 
describe the status of the data set and 
indicates what should be done with the data 
set after termination of the job step that 
processes it, or at the end of the job. 
The DISP parameter is coded on a DD 
statement. 



DCB; 



See data control block. 



DCB parameter ; This parameter is used to 
supply attributes about the data set that 
are needed to complete the data control 
block. The DCB parameter is coded on a DD 
statement . 



DD (data definition) statement ; 
control statement that defines a 



A job 
data set 

that is being created or retrieved in a job 
step. DD statements follow an EX^C 
statement . 



ddname 



(data definition name) ; A name 

This name 



assigned to a DD statement. 

corresponds to the ddname appearing in a 

data control block. 

DDNAME parameter ; This parameter is used 
to postpone the definition of a data set 
until later in the same job step and is 
coded on a DD statement. 

deferred r estart ; A restart that is 
performed when a job is resubmitted and the 
RESTART parameter is coded on the JOB 
statement of the resubmitted job. 

delimiter statement ; A job control 
statement used to mark the end of data. 
The characters /* appear in columns 1 and 2 
of this control statement. 

device type ; A number that corresponds to 
a type of input/output device. Coding the 
device type in the UNIT parameter is one 
way of indicating what input/output device 
you want allocated to a job step. 

direct ac c ess device ; An auxiliary storage 
device in which the access time is 
effectively independent of the location of 
the data set. 

direct data set ; A data set whose records 
are in random order on a direct access 
volume. Each record is stored or retrieved 



dispatching priority : The number assigned 
to a task, which in a multitask 
environment, determines the order in which 
the tasks may use main storage and CPU 
resources. 

DP RTY parameter ; This parameter is used to 
assign a dispatching priority to a job step 
and is coded on an EXEC statement. 

DSN parameter ; This parameter is used to 
assign a name to a new data set or to 
identify an existing data set and is coded 
on a DD statement. Coding DSN is the same 
as coding DSNAME. 

DSNAME parameter ; This parameter is used 
to assign a name to a new data set or to 
identify an existing data set and is coded 
on a DD statement. Coding DSNAME is the 
same as coding DSN. 

DUMMY parameter : This parameter is used to 
tell the system that the processing program 
should be executed, but no input or output 
operations should be performed on a 
particular data set. The DUMMY parameter 
is coded as the first parameter on a DD 
statement. 

dynamic storage ; That portion of main 
storage that is subdivided into partitions 
or regions for use by the programs 
associated with job steps and some system 
tasks. 



EXEC (execute) statement ; A job control 
statement that marks the beginning of a job 
step and identifies the program to be 
executed or the cataloged or in-stream 
procedure to be used. 

extent ; A contiguous area of storage on a 
direct access volume in which a data set 
resides. A data set may reside in more 
than one area of storage on one or more 
volumes. 
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F format ; A data set format in which the 
logical records are the same length. 



fixed-length record : A record having the 
same length as all other records with which 
it is logically or physically associated. 



generation data group ; A collection of 
data sets that are kept in chronological 
order; each data set is called a 
generation. The DSNAME parameter is used 
to define the generation you are creating 
or retrieving. 



generation data set ; One generation of a 
generation data group. 



group name ; A 1- to 8-character name that 
identifies a device or a collection of 
devices. Coding a group name in the UNIT 
parameter is one way of indicating what 
type of input /output device you want 
allocated to a job step. 



index ; 

1. A table in the catalog used to locate 
data sets . 

2. A table used to locate the records of 
an indexed sequential data set. 



indexed seguential data set ; A data set on 
one or more direct access volumes whose 
records contain a key portion, and the 
location of each record depends on the 
contents of the key portion. The location 
of each record is computed through the use 
of ein index. 

initiation ; The process of selecting a job 
step for execution and allocating 
input/output devices for the job step. 

input job queue ; A queue of summary 
information of job control statements 
maintained by the job scheduler , from which 
it selects the jobs and job steps to be 
processed. 

input stream ; The sequence of control 
statements and data submitted to the 
operating system on an input device 
especially activated for this purpose by 
the ope rat or - 

In- stream procedures ; A set of job control 
statements, beginning with a PROC statement 
and ending with a PEND statement, that have 
been placed in the input stream. An 
in- stream proced\ire can be executed any 
number of times during the job in which it 
appears. 



job; A total processing application that 
consists of one or more processing programs 
required to perform the application. A job 
is identified by a JOB statement. 



JOB statement ; A job control statement 
that marks the beginning of a job, and when 
jobs are stacked in the input stream, marks 
the end of the control statements for the 
preceding job. 



job class ; An alphabetic character of A 
through O that characterizes the type of 
job you are submitting. Each job class is 
defined by the installation; you indicate 
the type of job you are submitting in the 
CLASS parameter on the JOB statement. In 
multiprogramming systems, jobs within a job 
class are initiated according to their 
priority numbers. 

job control language ; A high-level 
programming language used to code job 
control statements, which describe a job to 
the operating system and inform the system 
of how the job is to be processed. 

job control statement ; Any one of the 
control statements in the input stream that 
identifies a job or defines its 
requirements . 

job library ; See private library. 

job management ; A general term that 
collectively describes the functions of the 
job scheduler and master scheduler. 

job processing ; The reading of control 
statements and data from an input stream, 
the initiating of job steps defined in 
these statements, and the writing of system 
output messages . 

job scheduler ; A control program function 
that controls input streams and system 
output, obtains input/output devices for 
jobs and job steps, and regulates the use 
of the computing system by jobs. The job 
scheduler is made up of the 
reader/interpreter , initiator/terminator, 
and output writer. 

job step ; The unit of work associated with 
one processing program or one cataloged 
procedure, and related data. A job 
consists of one or more job steps . 

JOBLIE ; A special ddname that when 
specified on a DB statement indicates to 
the system that you are defining a private 
library. 

jobnaroe ; The name assigned to a JOE 
statement; it identifies the job to the 
system. 
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1024 oytes. 



keyword ; A symbol that identifies 
parameter or subparameter. 



keyword parameter : A parameter that 
consists of a keyword followed by an equal 
sign, followed by a single value or a list 
of subparameters. Keyword parameters must 
follow positional parameters in the operand 
field of a job control statement, but the 
keyword parameters may appear in any order. 

LABEL parameter ; This parameter is used: 
(1) to describe the data set label 
associated with the data set; (2) to 
describe the sequence number of a data set 
that does not reside first on a reel; (3) 
to assign a retention period; (4) to assign 
password protection; and (5) to override 
the OPEN macro instruction (BSAM only) . 
The LABEL parameter is coded on a DD 
statement ,. 



ma ster scheduler : The part of the control 
program that responds to operator commands 
and returns required information. 



member : An independent, sequentially 
organized data set identified by a unique 
name in a data set directory. 

MET (multiprogramming with a fixed numbe r 
of tasks) ; A control program that provides 
priority scheduling of a fixed number of 
tasks. A priority scheduler is used in 
MET. 



MSGCLASS parameter : This parameter is used 
to assign an output class to the system 
messages for your job and is coded on a JOB 
statement. 

MSGLEVEL parameter : This parameter is used 
to indicate what jot control statements and 
allocation/termination messages you want 
displayed as output fromi your job and is 
coded on a JOB statement. 



librar y: 

1. In general, a collection of 
infojrmation associated with a 
particular use, and the location of 
which is identified in a directory of 
some type. In this context, see link 
library, private library, system 
library. 

2. Any partitioned data set. 

limit priority ; A priority associated with 
every task in an MVT system, representing 
the highest dispatching priority that the 
task may assign to itself or to any of its 
subtasks. 

link library ; A partitioned data set named 
SYSl.LINKLIB. Each member is a processing 
program and is called in the PGM parameter 
on the EXEC statement or in the ATTACH, 
LINK, LOAD, and XCTL macro instructions. 

logical record : A record that is defined 
in terms of the information it contains 
rather than by its physical traits. You 
may have to specify the length of the 
logical record to complete the data control 
block; one way to specify this is in the 
LRECL subparameter of the DCB parameter. 



main storage ; All addressable storage from 
which instructions can be executed or from 
which data can be loaded directly into 
registers. 

main storage hierarchy support : An option 
that divides main storage into two blocks 
known as hierarchies; hierarchy is 
assigned to processor storage and hierarchy 
1 to the IBM 2 361 Core Storage unit. 



multiprogramming ; Executing more than one 
job step concurrently. 

mutually exclusive ; The term applied to 
two parameters that cannot be coded on the 
same job control statement. 

MVT (multiprogramjning with a variable 
number of tasks) : A control program that 
provides priority scheduling of a variable 
number of tasks. A priority scheduler is 
used in MVT. 

MVT with Model 65 multiprocessing : An 
extension of MVT. This control program is 
used with the Model 65 multiprocessing 
(M65MP) system. 

M65MP; See MVT with Model 65 
multiprocessing . 



name: A 1- to 8-character term, beginning 
with an alphabetic or national (#, a, $) 
character, that identifies a data set, a 
control statement, a program, or a 
cataloged procedure. 

no nspecific volume request ; A request for 
volumes that allows the system to select 
suitable volumes. This type of request can 
only be made when defining an output data 
set. 

nontemporary data set ; A new data set that 
exists after the job that created it 
terminates. 

null statement : A job control statement 
used to mark the end of a job's control 
statements and data. 
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OUTLIM parameter ; This parameter is used 
to specify the ittaxiirum number of logical 
records you want included for the output 
data set being routed through the output 
stream. The OUTLIM parameter is coded on 
DD statement that must also contain the 
SYSOUT parameter. 



output class ; An alphabetic or numeric 
character that characterizes the type of 
output data to be written to a unit record 
device. Each output class is defined by 
the installation. For system messages, you 
indicate the type of output data in the ■ 
MSGCLASS parameter on a JOB statement; for 
output data sets, you indicate the type of 
output data in the SYSOUT parameter on a DD 
statement. 

output li s ti nq ; A form that is printed at 
the end of your job that may contain job 
control statements used by your job, 
diagnostic messages about your job, data 
sets created by your job, or a dump. 

output stream ; Diagnostic messages and 
other output data issued by the operating 
system or the processing program on output 
devices especially activated for this 
purpose by the operator. 

output writer ; A part of the job scheduler 
that writes output data sets onto a system 
output device, independently of the 
programs that produced the data sets. 

FARM parameter ; This parameter is used to 
supply a processing program with 
information it requires at the time the 
program is executed and is coded on an EXEC 
statement . 

parameter ; A character string that is 
recognized as having meaning by the 
reader/interpreter. For most of these 
character strings, variable information is 
provided to give a constant value for a 
specific process or purpose. 

partition ; In systems with MFT, a 
subdivision of the dynamic area of main 
storage set aside for a job step or a 
system task. 

partitioned data set ; A collection of 
independent groups of sequential records on 
a direct access volume, each of which is 
called a member. Each member has a unique 
name and is listed in a directory at the 
beginning of the data set. 

PGP (primary control program) ; A control 
program that provides sequential scheduling 
of jobs. 

PEND statement ; A job statement used to 
mark the end of an in-stream procedure. 



PGM parameter ; This parameter appears as 
the first parameter on an EXEC statement 
when you want to execute a particular 
program. 



physical record ; A record that is defined 
in terms of physical qualities rather than 
by the information it contains (logical 
record) . 



positional parameter ; A parameter that 
must precede all keyword parameters in the 
operand field of a job control statement. 
Positional parameters must appear in a 
specified order - 

primary quantity ; The initial amount of 
space on a direct access volume that you 
request in the SPACE, SPLIT, or SUBALLOC 
parameter . 

priority ; A rank assigned to each job step 
that determines the order in which job 
steps are selected for execution and 
requests for resources are satisfied. 

priority scheduler ; A scheduler used with 
MFT and MVT. Priority schedulers process 
complete jobs according to their initiation 
priority within job classes. Priority 
shcedulers can accept input data from more 
than one input stream. 

private ; The term applied to a moiinted 
volume that the system cannot allocate to 
an output data set for which a nonspecific 
volume request is made. A private volume 
is demounted after its last use in a job 
step. 

private library ; A partitioned data set 
whose members are not used often enough to 
warrant their inclusion in the link 
library. To execute a program that resides 
on a private library, you must define that 
library on a DD statement that has the 
ddname JOBLIB or STEPLIB. 

PROC parameter ; This parameter appears as 
the first parameter on an EXEC statement 
when you want to call a particular 
cataloged or in-stream procedure. 

PROC statement ; A job control statement 
used in cataloged or in-stream procedures . 
It can be used to assign default values for 
symbolic parameters contained in a 
procedure. For in-stream procedures, it is 
used to mark the beginning of the 
procedure. 

procedure step ; That unit of work 
associated with one processing program and 
related data within a cataloged procedure. 
A cataloged procedure consists of one or 
more procedure steps. 
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processing program ; Any program capable of 
operating in the problem program mode. 
This includes IBM-distributed language 
processors, application programs, service 
and utility programs, and user-written 
programs . 

PRTY param eter; This parameter is used to 
indicate the job's initiation priority 
within its job class and is coded on a JOB 
statement. 

public ; The term applied to a mounted 
volume that the system can allocate to an 
output data set for which a nonspecific 
volume request is made. A public volume 
remains mounted until the device on which 
it is mounted is required by another 
volume . 



qualified name ; A data set name that is 
composed of multiple names separated by 
periods (e.g., A.B.C.). For a cataloged 
data set, each name corresponds to an index 
level in the catalog. 



RD parameter ; This parameter is used to 
define the type of restart that can occur 
and is coded on a JOB or EXEC statement. 

reader/i nterpreter ; A job scheduler 
function that analyzes an input stream of 
job control statements. 

record ; A general term for any unit of 
data that is distinct from all others. 

region ; In systems with MVT, a subdivision 
of the dynamic area of main storage set 
aside for a job step or a system task. You 
can specify in the REGION parameter on the 
JOB statement or EXEC statement how large 
this area of main storage should be, 

REGION par a meter ; This parameter is used 
to specify how much contiguous main storage 
is required to execute a job step and can 
be coded on a JOB or EXEC statement . If 
main storage hierarchy support is included 
in the system, the REGION pareimeter is also 
used to identify the hierarchy or 
hierarchies in which the storage is to be 
allocated. 

resource ; Any facility of the computing 
system or operating system required by a 
job or task and includes main storage, 
input/output devices, the CPU, data sets, 
and control and processing programs. 

restart ; The process of resuming a job 
after it abnormally terminates. When a 
restart is performed, processing is 
continued either at the beginning of a job 
step that caused the abnormal termination 
or at a checkpoint within this job step. 



RESTART parameter ; This parameter is used 
to identify the step or the step and the; 
checkpoint within the step at which 
execution of a job is to be resumed and is 
coded on the JOB statement of a resubmitted 
job that is to use the checkpoint/restart 
facilities. 

ROLL parameter ; This parameter is used to 
specify a job step's ability to be rolled 
out or to cause rollout of another job step 
and is coded on a JOB or EXEC statement. 

rollout/rollin ; An optional MVT control 
program feature that allows the temporary 
assignment of additional main storage to a 
job step. 



scheduler ; See job scheduler. 

se condary quantity ; The additional amount 
of space on a direct access volume that you 
want allocated to a data set if the priirary 
quantity requested in the SPACE, SPLIT, or 
SUBALLOC parameter is not sufficient. 

secondary storage ; See auxiliary storage. 

SEP parameter ; This parameter is used to 
request channel separation from specific 
data sets defined earlier in the job step 
and can be coded on a DD statement. 

sequential data set ; A data set whose 
records are organized on the basis of their 
successive physical positions, such as they 
are on magnetic tape. 

SPACE parameter ; This parameter is used to 
indicate how much space should be allocated 
on a direct access volume for a new data 
set and is coded- on a DD statement . 

specific volume request ; A request for 
volumes that informs the system of the 
volume serial numbers. 

SPLIT parameter ; This parameter is used to 
allocate space to two or more new data sets 
that are to share cylinders. The SPLIT 
parameter is coded on a DD statement. 

STEPLIE ; A special ddname that when 
specified on a DD statement indicates to 
the system that you are defining a private 
library. 

stepname ; The name assigned to an EXEC 
statement; it identifies a job step within 
a job. 

step restart ; A restart at the beginning 
of a job step that abnormally terminates. 
The restart may be automatic (depending on 
an eligible completion code and the 
operator's consent) or deferred, where 
deferred involves resubmitting the job and 
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coding the RESTART parameter on the JOB 
statement of the resubmitted job. 



system data sets ; The data sets that make 
up the lEM System/360 Operating System. 



storage volume : The main function of a 
storage volume is to contain nontemporary 
data sets for which a nonspecific volume 
request was made and PRIVATE was not coded 
in the VOLUME parameter. A direct access 
volxime becomes a storage volume when so 
indicated in a MOUNT command or in a member 
of SYSl.PARMLlB named PRESSES. 



SUBALLOC parameter ; This parameter is used 
to place a series of a new data sets in one 
area of contiguous space on a direct access 
volume and in a certain sequence. The 
SUBALLOC parameter is coded on a DD 
statement. 

subpararoeter ; One of the items of variable 
information that follows a keyword 
parameter and can be either positional or 
keyword . 

symbol ; In the IBM System/360 Operating 
System, any group of eight or less 
alphameric and national characters that 
begins with an alphabetic or national 
(#,a,$) character. 

symbolic parameter ; A symbol preceded by 
an ampersand that appears in a cataloged 
procedure. Values are assigned to symbolic 
parameters when the procedure in which they 
appear is called. 

SYSABEND ; A special ddname that when 
specified on a DD statement tells the 
system you are defining a data set on which 
a dump can be written if the step 
abnormally terminates. The dump provided 
includes the system nucleus, the processing 
program storage area, and possibly a trace 
table. 

SYSCHK ; A special ddname that when 
specified on a DD statement that precedes 
the first EXEC statement in the job tells 
the system you are defining a data set that 
contains checkpoint entries. This DD 
statement is included in a job that is 
being resubmitted for execution and 
execution is to begin at a particular 
checkpoint, 

SYSCTLG ; The name of a system data set 
that contains the name and location of 
cataloged data sets. 

SYSIN ; A name conventionally used as the 
data definition name of a data set in the 
input stream. 

SYSOUT parameter : This parameter is used 
to assign an output class to an output' data 
set and can be coded on a DD statement. 



system generation ; The process of 
producing an operating system made up of 
standard and optional components. 



system input device ; A device specified as 
a source of an input streeim. 



system library ; One of the collection of 
all cataloged data sets at an installation. 

system management facilities ; An optional 
control program feature that provides the 
means of gathering and recording 
information that can be used to evaluate 
system usage. 

system messages : ^iessages issued by the 
system that pertain to a problem program. 
These messages appear on an output listing 
and may include such messages as error 
messages, disposition messages, and 
allocation/de-allocation messages . 

system output device ; An output device, 
shared by all jobs, onto which specified 
output data is written. 

SYSUDUMP ; A special ddname that when 
specified on a DD statement tells the 
system you are defining a data set en which 
a dump can be written if the step 
abnormally terminates. The dump provided 
is the processing program storage area. 

SYSl.LINKLIB ; The name of a partitioned 
data set that contains the IBM-supplied 
processing programs and part of the 
nonresident portion of the control program;. 
It may also contain user-written programs. 

SY Sl.PROCLIB ; The name of a partitioned 
system data set that contains cataloged 
procedures. 

SYSl.SYSJOBQE ; A System data set that 
contains information about the input and 
output streams, and contains the input and 
output queues. 



task; The smallest unit of work that can 
be perform,ed under the control program. 

temporary data set ; A new data set that is 
created and deleted in the same job. 

termination ; The process of performing 
disposition processing, as specified in the 
DISP parameter, de-allocating input/output 
devices, and supplying control information 
for writing job output on a system output 
unit. 
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TIME parameter ; This parameter is used to 
assign a time limit on how long the job or 
a particular job step can use the CPU and 
is coded on a JOB or EXEC statement, or 
both. 

time- slicing ; The sharing or the CPU by 
certain tasks for an equal, predetermined 
length of time . 

'YPRUN parameter ; This parameter is used 
CO hold a job for execution until the 
operator issues a RELEASE command and is 
coded as TYPRUN=HOLD on a JOB statement. 



V format ; A data set format in which 
Logical records are of varying length and 
include a length indicator; and in which V 
format logical records may be blocked, with 
each block containing a block length 
indicator. 



VOL parameter ; This parameter is used to 
identify the volume Cs) on which a data set 
resides or will reside and is coded on a DD 
statement, coding VOL is the same as 
coding VOLUME. 



UCS paramet er; This parameter is used to 
describe tloe character set you want to use 
for printing an output data set on a 1U03 
printer. The UCS parameter is coded on a 
DD statement. 

unit addres s; A 3-byte number, made up of 
the channel, control unit, and unit 
numbers, that identifies a particular 
device. Coding a unit address in the UNIT 
parameter is one way of indicating what 
input/output device you want allocated to 
the job step. 

UNIT parameter ; This parameter is used to 
describe what device and how many devices 
you want assigned to a data set. The UNIT 
parameter can be coded on a DD statement. 



volume ; That portion of an auxiliary 
storage device that is accessible to a 
single read/write mechanism. 



VOLUME parameter ; This parameter is used 
to identify the volume(s) on which a data 
set resides or will reside and is coded on 
a DD statement. Coding VOLUME is the same 
as coding VOL. 



volume table of contents (VTOC) ; A table 
in a direct access volume that describes 
each data set on the volume. 
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parameter 37 
JOBLIB DD statement 108-110,72 

(see also STEPLIB) 

concatenating private libraries 109 

examples of 110 

glossary 301 

parameters to code when 
cataloged 108-109 
not cataloged 108-109 

rules for coding 108 
Jobname 

assigning a 31 

examples of 31 

glossary 301 

K 

glossary 302 
KEEP subparameter in the DISP parameter 

157,159 
Kept data set 

retrieving 294-295 
KEYLEN, DCB subparameter lUO 
coded with 

SPACE parameter 18U 
SPLIT parameter 191 
SUBALLOC parameter 195 
mutually exclusive with 
CODE 137 
MODE 141 
PRTSP 143 
STACK 146 
TRTCH 146-147 
Keyword 

glossary 302 
Keyword parameters 

on DD statement 124-227,102-103,104-105 

on EXEC statement 77-99,66 

glossary 30 2 

on JOB statement 37-63,28 

rules for coding 19 



LABEL parameter on DD statement 171-17 6 

coded on SYSCHK DD statement 116,117 

coded when 

creating generation data set 28 5 
creating ISAM data set 276 
retrieving generation data set 28 6 
retrieving passed data set 158 

data set seguence number subparameter 
173 

examples of 175-176 

EXPDT subparameter 175 

format of 171 

glossary 302 

IN subparameter 174-175 

label type subparameter 173-174 

OUT subparameter 174-175 

PASSWORD subparameter 174 

RETPD siibparameter 175 

rules for coding 172 

when to code 172-173 
Labels types 173-174 
Labels 

data set 172 

direct access 172 

nonstandard (NSL) 173,174 

standard (SL) 173,174 

standard and user (SUL) 173 

tape 172 
Lengthening a data set 

space requirements 
SPACE parameter 18 5 
SUBALLOC parameter 196 

specifying status 154 

volume sequence number subparameter 220 
Libraries, concatenating private 109,112 
Library 

glossary 302 

private 108-113,72 

procedure 75,247 

system 72 

temporary 71 
LIMCT, DCB subparameter 14 

OPTCD=E 142 
Limit priority 

glossary 302 
Link library 72 

glossary 302 
Logical record 

glossary 302 
LRECL, DCB subparameter 14 



Main storage 

acquiring additional 59-60,95-96 

glossary 302 

REGION parameter on EXEC statement 
91-95 

REGION parameter on JOB statement 51-54 
Main storage hierarchy support 53-54, 93-Qf 

glossary 302 
Master scheduler 

glossary 302 
Member 

glossary 302 
Member name, assigning a 167,168 
MET (multiprogramming with a fixed number 
of tasks) 

glossary 302 
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MOD subparameter in the DISP parameter 155 
MODE, DCB subparameter lUl 

mutually exclusive with 
CODE 137 
KEYLEN 140 
PRTSP 143 
TRTCH 146-147 
Model data set label 283-284 
Mount attributes 223-225 
Mounting 

deferred 214 

parallel 214 
MSGCLASS parameter on JOB statement 41 

assigning an output class 41 

coded with SYSOUT parameter 41,202 

default 41 

examples of 41 

format of 41 

glossary 30 2 

rules for coding 41 
MSGLEVEL parameter on JOB statement 4 3-44 

default 43,291 

examples of 44 

format of 43 

glossary 30 2 

restart in MFT, MVT 48,88 

rules for coding 43 
Multiprogramming 

glossary 30 2 
Mutually exclusive parameters 

glossary 30 2 

overriding with 2 57 
MVT (multiprogramming with a variable 
number of tasks) 

glossary 30 2 
MXIG subparameter in the SPACE parameter 
186 



Name 

glossary 302 
Name field 18 

example of 19 
National character set 23 

NC subparameter in the RD parameter 48,88 
NCP, DCB subparameter 141 
New output data set 

creating 293-294 
NEW subparameter in the DISP parameter 155 
NL subparameter in the LABEL parameter 

173,174 
Nonsharable attribute 226 
Nonspecific volume request 219 

for direct access volume 184, 219 

glossary 302 

satisfying a 226-227 

for tape volume 174,219 
Nonstandard labels 

label type subparameter 173,174 

processing routines for 173 
Nontemporary data set 

creating 293-294 

glossary 302 
NR subparameter in the RD parameter 48,88 
NSL subpareimeter in the LABEL parameter 
173,174 



NTM, DCB subparameter 141 

OPTCD=M 142 
Null statement 

example of 2 37 

format of 237 

glossary 302 
NULLFILE 128,260 
Nullifying 

DCB subparameter s 259 

DD statement parameters 259-260 

DUMMY parameter 128,260 

EXEC statement parameters 24 5 



OLD subparameter in the DISP parameter 155 
ONLY subparameter in the COND parameter 

80-81 
Operand field 18 

blank 2 62 

example of 19 

keyword paraineters 19 

positional parameters 19 

subparameter s 19 
Operation field 18 

example of 19 
Operator commands 23 0-232 
Operator subparameter in the COND 

parameter 3 9,80 
OPTCD, DCB subparameter 142-143 
OUT subparameter in the LABEL parameter 

174-175 
OUTLIM parameter 177 

coded with SYSOUT parameter 177 

determining the output limit 177 

example 177 

glossary 303 

rules for coding 177 
Output of 

allocation messages 43 

allocation recovery messages 43 

disposition messages 43 

job control statements 43 
Output class 

glossary 303 

for system messages 41 
Output class subparameter in the MSGCLASS 

parameter 41 
Output data set 

allocating space for 181-197 

creating 293-294 

lengthening 155 

OUT subparameter 17 4,17 5 

printed using UCS feature 205-207 

providing 

unit information 210-211 
volume information 218 

routed through output stream 199-204 

specifying ' 

conditional disposition 159-160 
disposition 156-158 
status 154-156 
Output listing 

glossary 303 
Output stream 

glossary 303 

routing data sets through the 199-204 
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Output writer 201-202 

qlossary 303 
Overflow area 275 
Overriding 

concatenated data sets 262 

DCB subparameters 258 

DD statement parameters 257-258 

EXEC statement parameters 2 53-254 

with mutually exclusive parameters 

PARM parameter 254 

TIME parameter 2 54 



257 



P subparameter in the UNIT parameter 214 

Parallel mounting 214 

Parameter 

glossary 303 
Parentheses 

to enclose a subparameter list 19 
inclusion in variables 24 
PARM parameter on EXEC statement 8 5-86 
examples of 86 
format of 8 5 
glossary 303 
overriding the 85,254 
rules for coding 85 
special characters in 85,24 
Partition 

glossary 303 
Partitioned data set 
concatenating 22 
creating 294 

executing programs in a 71-73,108-113 
glossary 303 
lengthening 155 
name 

nontemporary 166 
temporary 168 
retrieving a member of 294 
space for directory 

in SPACE parameter 18 5,186 
in SUBALLOC parameter 196 
PASS subparameter in the DISP parameter 

157-158 
Passed data set 
providing 

data set name 157 
DCB information 158 
disposition 157 
label type 173,157 
unit information 210,158 
retrieving 295 
Password protection 174 
PASSWORD subparameter in the LABEL 

parameter 174 
PCP (primary control program) 

glossary 303 
Permanently resident volume 223 
PGM parameter on EXEC statement 71-73 
backward references 71-72,22 
examples of 72-73 
executing programs from 

private library 108-113 ,72 
system library 72 
temporary library 71 
format of 71 
glossary 30 3 



,71-72 
108-113,71-72 



Physical record 

glossary 303 
Positional parameters 

on DD statement 119-128,102 

on EXEC statement 71-75,66 

glossary 303 

on JOB statement 33-35,28 

rules for coding 19 
Postponing definition of a data set 

DDNAME parameter 149-152 
PRESRES entry 223 
Primary quantity 

glossary 303 

in SPACE parameter 184,186-187 

in SPLIT parameter 190-191 

in SUBALLOC parameter 195 
Prime area 275 
Priority 

glossary 303 

initiation 4 5 

job 45 

job class 45 

step 83 
Priority parameter 

(see PRTY) 
Priority scheduler 

glossary 303 
Private 

glossary 303 
Private libraries 108-113 

concatenating 109,112 

executing programs from 

glossary 303 
PRIVATE subparameter in the VOLUME 

parameter 219-22 
Private volume 219,223-225 
PROC parameter on EXEC statement 75,249 

examples of 75 

format of 75 

glossary 303 
PROC statement 241-2 43 

assigning values to symbolic parameters 
on 242-243 

example of 243 

format of 241 

glossary 303 

rules for coding 241-242 
Procedure 

(see cataloged procedure) 
Procedure library 75,247 
Procedure name 75,24 7 
Procedure step 2 47 

glossary 303 
Processing program 

glossary 304 
Processor storage 53-54,93-95 
Program 

calling a 71-73 
Program name 71 

subparameter in the SYSOUT parameter 
202 
Programmer's name parameter on JOB 
statement 3 5 

examples of 35 

format of 35 

requirement for coding 291 

rules for coding 35 

special characters in 35,24 
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PRTSP, DCB subparameter 143 
mutually exclusive with 
CODE 137 
KEYLEN 140 
MODE 141 
STACK 146 
TRTCH 146-147 
PRTY parameter on JOB statement 4 5 
default 46,291 
examples of 4 5 
format of 4 5 
glossary 304 
rules for coding 4 5 
time- si icing in MVT 4 5 
Public 

glossary 304 
Public volume 219,223-225 



QISAM data set 

(see ISAM data set) 
Qualified name 

assigning a 166-167 

glossary 304 



R subparameter in the RD parameter 48,88 
RD parameter on EXEC statement 87-8 9 
defining restart 88 
examples of 89 
format of 87 
glossary 304 
overriding the 88 
restart facilities 87 
rules for coding 87 
RD parameter on JOB statement 47-49 
defining restart 48 
examples of 49 
format of 47 
glossary 304 
restart facilities 47 
rules for coding 47 
Reader procedure 

defaults supplied in the 28 9-291 
Reader/interpreter 

glossary 304 
RECFM, DCB subparameter 144-14 5 
Record 

glossary 304 
REF subparameter in the VOLUME parameter 

221-222 
References, backward (see backward 

references) 
Region 

glossary 304 
REGION parameter on EXEC statement 91-95 
glossary 304 

with main storage hierarchy support 
93-95 

acquiring additional main storage 94 
default 93-94,291 
examples of 94-95 
format of 93 
overriding the 94 
rules for coding 9 3 



REGION parameter on EXEC statement 
(continued) 

without main storage hierarchy support: 
91-92 

acquiring additional main storage 91 
default 91,291 
examples of 92 
format of 91 
overriding the 91 
rules for coding 91 
REGION parameter on JOB statement 51-54 
glossary 304 

with main storage hierarchy support 
53-54 

acquiring additional main storage 54 
default 53-54,291 
examples of 54 
format of 53 
rules for coding 53 
without main storage hierarchy support: 
51-52 

acquiring additional main storage 51 
default 51,2 91 
examples of 51-52 
format of 51 
rules for coding 51 
Relational operators in the COND parameter 

39,80 
Relative generation number 283 
Relative track number 186-187 
Releasing unused space (see RLSE) 
Remote job entry 

restriction on use of BUFNO subparameter 
with * parameter 120 
with DATA parameter 124 
with DDNAME parameter 151 
Removable volume 223-225 
REPOS, DCB subparameter 145 
Reserved volume 223-225 
Resource 

glossary 304 
Restart 

glossary 304 
types of 269-271 
Restart definition (RD parameter) 
on EXEC statement 87-89 
on JOB statement 47-49 
Restart facilities 

examples of 272-273 

RD parameter on EXEC statement 87-88 
RD parameter on JOB statement 47-48 
RESTART parameter on JOB statement 55 
REPOS, DCB subparameter 
RESTART parameter on JOB statement 55-57 
examples of 56-57 
format of 55 
glossary 304 
rules that apply when 

defining generation data set 56 
making backward reference 56 
rules for coding 55 
RETAIN subparameter in the VOLUME 

parameter 220 
Retention period 175 
effect on 

DELETE subparameter 157-158,159 
KEEP subparameter 157,159 



316 JCL Reference 



RETPD subparameter in the LABEL parameter 

175 
Retrieving data sets 294-295 

cataloged 294 

generation data set 286, 295 

indexed sequential data set 280,295 

member of partitioned data set 294 

noncataloged 

data set with direct organization 294 
sequential data set on direct access 

volume 294 
on a tape volume 294 

passed data set 157-158,295 
Return code 39,80 
Return code test 39,80 

effect on disposition processing 156 
RKP, DCB subparameter 146 
RLSE subparameter in the SPACE parameter 
185-186 

effect on existing data set 18 5 

when overriding 260 
RNC subparameter in the RD parameter 48,88 
ROLL parameter on EXEC statement 97-98 

default 97,291 

examples of 98 

format of 97 

glossary 304 

overriding the 97 

rules for coding 97 
ROLL parameter on JOB statement 59-60 

default 59,291 

examples of 60 

format of 59 

glossary 304 

rules for coding 59 
Rollout/roll in 59,97 

glossary 304 
ROUND subparameter in the SPACE parameter 
186 



Scheduler 

glossary 304 
Scratch volume 220,223-225 
Secondary quantity 
glossary 304 
when overriding 260 
in SPACE parameter 184-185 
in SPLIT parameter 190-191 
in SUBALLOC parameter 196 
Secondary storage 
glossary 304 

Programming Notes 
The JOB Statement 

The EXEC Statement 65-99 
The DD Statement 101-227 
The Command Statement 229-232 
The Comment Statement 233 
The Delimiter Statement 235 
The Null Statement 237 



17-2 5 
27-63 



Section I: 

Section II: 

Section III 

Section IV: 

Section V: 

Section VI: 

Section VII: 

Section VIII; 

Section IX: The PEND Statement 239 

Section X: The PROC Statement 241-243 

Section XI: Appendixes 245-297 

Section XII: Glossary 299-306 



Section XIII: Control Statement Foldout 

Charts 323-327 
SEP parameter on DD statement 179-180 
examples of 180 
format of 179 
glossary 304 

requesting channel separation 179 
rules for coding 17 9 
SEP subparameter in the UNIT parameter 215 
Separation 

channel 179-180,129-130 
unit 215 
Sequence number 
data set 173 
vol\mie 22 
Sequential data set 
concatenating 22 
creating 293-294 
qlossary 304 
lengthening 157-159 
retrieving 2 94 
SER subparameter in the VOLUME parameter 

221 
Sharing 

cylinders 18 9-192 
data set 155 
SHR siabparameter in the DISP parameter 155 
SL subparameter in the LABEL parameter 

173,174 
SOMA, DCB subparameter 146 
SPACE parameter on DD statement 181-188 
(see also SPLIT; SUBALLOC) 
assigning specific tracks 186-187 
coded on 

SYSABEND DD statement 114 
SYSUDUMP DD statement 114 
coded when 

creating generation data set 28 5 
creating ISAM data set 277 
coded with SYSOUT parameter 202-204,291 
examples of 187-188 
format of 181 
glossary 304 

letting system assign specific tracks 
183-186 

allocating whole cylinders 18 6 
releasing unused space 185-186 
requesting space for directory 

185,186 
requesting space for index 

185,186-187 
specifying format 186 
specifying primary quantity 184 
specifying secondary quantity 184-185 
unit of measurement 183-184 
requesting space 182-186 
rules for coding 182 
Special character set 23 
with UCS parameter 2 05 
using 23-24 
Special ddnames 107-117 
Specific volume request 218-219 

for direct access volume 219,184 
glossary 304 
satisfying a 226 
for tape voluir.e 219-220 
Split cylinder mode 190 
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SPLIT parameter on DD statement 189-192 
(see also SPACE; SUBALLOC) 
coded on 

SYSABEND DD statement IIU 
SYSUDUMP DD Statement lit 
examples of 19 2 
format of 18 9 
glossary 30U 
requesting space 190-191 
rules for coding 18 9 
STACK, DCB subparameter 146 
mutually exclusive with 
CODE 137 
KEYLEN lUO 
PRTSP 143 
TRTCH: 146-147 
States, volume 222-227 
Status subparameter in the DISP parameter 

154-156 
Step dispatching priority (see DPRTY) 
Step restart 

automatic 47,8 7,269 
deferred 55-57,269-270 
glossary 304 
STEPLIB DD statement 111-113,71-72 
(see also JOBLIB) 

concatenating private libraries 112 
examples of 112-113 
glossary 304 
parameters to code when 
cataloged 111 

not cataloged or not passed 111-112 
passed 112 
rules for coding 111 
Stepname 

assigning a 69 
excimples of 69 
glossary 304 
Storage volume 223-225 

glossary 30 5 
Stream, input, data sets in the 119-126 
Stream, output, routing data sets through 

the 199-204 
SUBALLOC parameter on DD statement 19 3-197 
(see also SPACE; SPLIT) 
coded on 

SYSABEND DD Statement 114 
SYSUDUMP DD Statement 114 
examples of 197 
format of 19 3 
glossary 305 
requesting space 194-196 
rules for coding 194 
Suballocation 194 
Subparameter 

glossary 30 5 
rules for coding 19 
SUL subparameter in the LABEL parameter 

173 
Suppressing 

CHKPT macro instruction 47,87 
automatic restarts 47,87 
Symbol 

glossary 305 
Symbolic parameters 265-267,249-251 

assigning default values to 241-243 
assigning values to 249-250 
defining 265-267 



Symbolic Parameters (continued) 
definition of 265-266,20 
examples of 266,249 
glossary 305 
nullifying 250-251 
PROC statement 241-243,266 
SYSABEND DD Statement 114-115 
(see also SYSUDUMP) 
examples of 115 
glossary 305 
storing the dimip 114 

writing the diimp to unit record device 
114 
SYSCHK DD statement 116-117 

with deferred restart 56,270 
examples of 117 
glossary 305 
parameters to code when 
cataloged 116 
not cataloged 117 
rules for coding 116 
SYSCTLG 

glossary 305 
SYSIN as a ddname 12 

glossary 305 
SYSOUT parameter on DD statement 199-204 
coded on 

SYSABEND DD statement 
SYSUDUMP DD Statement 
glossary 305 
for MET, MVT 201-204 
examples of 203-2 04 
format of 2 01 
rules for coding 201 
specifying classname 
specifying DCB parameter 203-204 
specifying form number 204 
specifying MSGCLASS parameter 202 
specifying program name 20 2 
specifying SPACE parameter 

203,291,289 
specifying UNIT parameter 203,291 
for PCP 199-200 
examples of 2 00 
format of 199 
rules for coding 199 
specifying classname 199 
specifying DCB parameter 199 
System data set 

glossary 305 
System generation 

glossary 305 
System input devices 

glossary 305 
System library 72 

glossary 305 
System management facilities 
glossary 305 

with TIME parameter 61-62,97-98 
System messages 
glossary 305 
output class 41 
System output device 

glossary 305 
SYSUDUMP DD Statement 114-115 
(see also SYSABEND) 
examples of 115 
glossary 305 



114 
114 



202 
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SYSUDUMP DD Statement (continued) 

storing the dump 114 

writing the dump to unit record device 
114 
SYSl.LINKLIB 72 

glossary 305 
SYSI.PROCLIB 75,249 

glossary 305 
SYSl.SYSJOBQE 

glossary 305 



Tape devices, list of 212 
Task 

glossary 305 
Teleprocessing 

what to code in ROLL parameter 59, 95 
Temporary data set 

creating 293 

glossary 305 
Temporary library 71 
Termination 

glossary 305 
Time limit 

CPU 61,97 

wait state 61-62,97 
TIME parameter on EXEC statement 97-9 9 

affect of JOB limit 98 

CPU time limit 
default 97,291 
with SMF 97 
without SMF 97 

eliminating timing 9 8 

examples of 98-99 

format of 97 

glossary 306 

overriding the 98,254 

rules for coding 97 

wait-state time limit 
with SMF 97 
without SMF 97 

1440 98 
TIME parameter on JOB statement 61-62 

affect of JOB time limit 98 

CPU time limit 
with SMF 61 
without SMF 61 

eliminating timing 62 

examples of 62 

format of 61 

glossary 306 

rules for coding 61 

wait-state time limit 
with SMF 61-62 
without SMF 62 

1440 62 
Time- slicing 

glossary 306 

in MFT 83-84 

in MVT 45,83-84 

for a job 45 

for a step 83-84 
Timing 

CPU 97,61 

eliminating 62,98 
Track number, relative 18 6-187 



TRK subparameter 

in SPACE parameter 183 
in SUBALLOC parameter 195 
TRTCH, DCB subparameter 146-147 
for checkpoint data set 116,117 
mutually exclusive with 

CODE 137 

KEYLEN 14 

MODE 141 

PRTSP 143 

STACK 146 
TYPRUN parameter on JOB statement 63 
example of 63 
format of 63 
glossary 306 
rules for coding 63 



UCS parameter on DD statement 20 5-20 7 
examples of 207 
format of 2 05 
glossary 306 

identifying character set 206 
requesting 

fold mode 2 07 
operator verification 207 
rules for coding 205 
special character sets 205 
UNCATLG subparameter in the DISP parameter 

158,160 
Unit address 211 

glossary 306 
Unit affinity 215 

nonsharable attribute 226 
Unit count subparameter in the UNIT 

parameter 213-214 
UNIT parameter on DD statement 209-216 
coded on 

JOBLIB DD statement 109 
STEPLIB DD statement 112 
SYSABEND DD Statement 114 
SYSCHK DD statement 117 
SYSUDUMP DD Statement 114 
coded when 

creating generation data set 284-285 
creating ISAM data set 276 
retrieving generation data set 28 6 
retrieving ISAM data set 280 
retrieving passed data set 157 
examples of 215-216 
fonriat of 209 
glossary 306 

identifying the device 211-213 
providing unit information 210-215 
rules for coding 209-210 
specifying 

deferred mounting 214 
parallel mounting 214 
SYSOUT parameter 202-204,291 
unit affinity 215 
unit count 213-214 
unit separation 215 
with suballpcation 194 
Unit record devices 
list of 212-213 
writing dumps to 114 
Unit separation 215 
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Universal character set (see UCS) 
Unqualified name, assigning 166 
Use attributes 222-225 



V format 

glossary 306 
VERIFY subparameter in the UCS parameter 

207 
VOL parameter on DD statement (see VOLUME 

parameter) 
volume 

glossary 306 
permanently resident 223 
private 219,223-225 
public 219,223-225 
removable 223-225 
reserved 223-225 
scratch 220,223-225 
storage 223-225 
Volume count subparameter in the VOLUME 

parameter 221 
VOLUME parameter on DD statement 217-227 
backward reference 221-222,22 
coded on 

JOBLIB DD statement 109 
STEPLIB DD statement 112 
SYSABEND DD statement 114 
SYSCHK DD statement 116,117 
SYSUDUMP DD Statement IIU 
coded when 

creating generation data set 285 
creating ISAM data set 276 
retrieving ISAM data set 280 
examples of 227 
format of 217 
glossary 306 

providing volume information 218-222 
referring to specific request 221-222 
rules for coding 218 



VOLUME parameter on DD statement 
(continued) 
specifying 

PRIVATE subparameter 219 

RETAIN subparameter 220 

volume sequence number subparameter 

220 
volume count siibparameter 221 
with suballocation 194 
supplying serial numbers 221 
Volume sequence number subparameter in the 
VOLUME parameter 22 

for checkpoint entry 116 
Volume serial number 221 

for checkpoint entry 116,117 
special characters in 221,24 
Volume states 222-227 
Volume table of contents (VTOC) 

glossary 306 
VOLUME^REF 

backward references 221-222,22 



Wait state time limit 
with SMF 61-62,97 
without SMF 62,97 



X/ 2 49 
XX 2 49 
XX* 249,21 



1440 62,98 

2321 data cell drive 
unit address 211 
\init affinity 215 

2361 core storage 53,93 
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Section XII: Control Statement Foldout Charts 



( 



The JOB Statement 


//Name 


Operation 


Operand 


P/K 


Comments 


//jobname 


JOB 


([account number] [, additional accounting information,,..]) 


P 


Can be made mandatory 






fprogrammer's name] 


P 


Can be made mandatory 






[CLASS=jobclass] 


K 


Assign A-O. For MET and MVT. 






[COND=((code, operator) ,,..)] 


K 


Maximum of 8 tests 






[MSGCLASS=output class] 


K 


Assign A-Z, 0-9, For MET and MVT. 








MSGLEVEL=( 




1 
2 


To] 

[,lj) 




K 








rPRTY=priorit>'j 


K 


Assign 0-13. For MFT and MVT, 








R 
RD= RNC 
NC 
(NR 




K 


Restart definition 








REG!ON=(|valueK )[,value]K]) 
valueoKl 




K 


F*or MVT 








RESTART=( 

L 


stepname 

stepnome . procstepname 


[,checkidj) 




K 


For deferred restart 






rROLL=(/YESH,YES))] 
L lNO/t,NO/J 


K 


Rollout/rollin, For MVT. 






TIME=f (minutes, seconds)) 
[ 11440 /J 


K 


Assigns Job CPU time limit. 
For MFT and MVT. 






[typrun=holdJ 


K 


Holding a [ob in job queue. 
For MFT and MVT. 


Legend: 






P Posirional parameter. 






K Keyword parameter. 
j { Choose one. 

[] Cptiona!; if more tha.i one line is en:losea , cr.oose CTe or none . 




1 



rt 1 



Chart 1 



Section XII: control Staterrent Foldout Charts 321 



The EXEC Statement 



//Nan 



//[stepnamej 



Operation 



EXEC 



Operand 



^program name 
I PGM=<*.stepname.dclname 
I V .stepname.procstepname.ddname 

LPR0C=J procedure name 



[ACCT=(accounting information,,..) "I 

ACCT.procstepname=(accounting information, . . .) 



COND = 



(code, operator) 

(code, operator, stepname) 

(code, opera tor, stepname.procstepname) 



LOMLYj 



C OND . procstepname=( 



(code, operator) 

(code , operator , stepname) 

(code, opera tor, stepname.procstepname) 



,...[,]rEVENl) 

|_onlyJ 



rDPRTY=(valuel,value2) 1 

|_DPRTY . procstepname=(va lue 1 , va lue2)J 



rPARM=value 1 

|_P ARM . procstepname=va luej 



IR 
RNC 
NC 
NR 



R 



RD .procstepname=)RNC 
NC 
NR 



REGION=(JvalueK ^,valueiK]) 

iK 
:oK/ 



(^valueK 1 [ 
ValueoKj 



REGiON.procstepname=((valueK )[» v^liJ^l '^j) 
\valu 



ROLL=(/YESU,YES)) 
lNO/(,NO/ 
ROLL. procstepname=( (YES U, YES 1) 
lNO/l,NO/ 



TIME 



=/(minutes, seconds)! 
11440 / 



TIME .procstepname=/( minutes, seconds) 



/(minutes, seconds)) 
U440 / 



Legend : 

P Positional parameter. 

K Keyword oarameter, 

] f Choose one . 

fi Optional; if more than one line is enclosed , choose one or none. 



P/K 



Comments 



identifies program or 
cataloged procedure 



Accounting information for step 



Maximum of 8 tests, or 7 tests 
ff EVEN or ONLY is coded 



Assign values of 0-15. For MVT. 



Parentheses or apostrophes 
enclosing value may be required 



Restart definition 



For MVT 



Rollout/rollln. For MVT. 



Assigns step CPU time limit. 
For MET and MVT. 
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The DD Statement 



//Name 



// 



ddname 
procstepname, 
ddname 



Operation 



P/K 



Comments 



DD 



DATAJ 

[dummy] 

[AFF=ddname] 



DCB=(list of attributes) 

[ dsname 1 

*. ddname I [, list of attributes] ) 

*.stepname. ddname ( 

*.stepname. procstepname. ddname 1 



DCB=(- 



[pDNAME=ddname] 



r 






NEW 


DISP={ 


OLD 




SHR 




MODj 


^ 





DELETE 

KEEP 

PASS 

CATLG 

UNCATLG 



, DELETE 
,KEEP 
, CATLG 
, UNCATLG 



dsname 

dsname(member name) 

dsname(generation number) 

dsname(area name) 
DSNAME/ =/ &&dsname 
DSN ( \ &&dsname(member name) 

&8<dsname(area name) 
.ddname 

* . stepname . ddname 
, stepname . procstepname . ddname 



LABEL=(Cdata set seq #] 



[SEP=(ddname,...)] 



,SL 

,SUL 

,NSL 

,NL 

,BLP 



r, PASSWORD 1 r,IN 1 M rEXPDT=yyddd]) 
L, J L,OUtJ [RETPD=nnnn J 



TRK 
'SPACE=( CYL , (primary 

I blocklength ) 



, secondary 
SPACE=(ABSTR, (primary q uontity, address T, directory"! )) 



, directory 
, index 



,RLSE 



,CONTIG 

,MXIG 

,ALX 



, round])] 



if, directory"! ) 
|_, index J 



P I To define a data set in the Input stream 



P i To bypass I/O operations on a data set 
(BSAM and QSAM) 



One way '' 'squest channel separat'or 



To complete the data control block. See 
Glossary of DCB Subporometers . 



To postpone the definition of a data set 



To assign a status, disposition, and 
conditional disposition to the data set 



To assign a name to a new data set or to 
identify an existing data set. An 
unqualified name Is 1-8 characters, 
beginning with an alphabetic or national 
character. 



To supply label information 



One way to request channel separation. 
Code up to 8 ddnames. 



To assign space on a direct access volume 
for a new data set 

To assign specific tracks on a direct access 
volume for a new data set 



Legend: 

P Positional parameter. 

K Keyword parameter. 

J » ^, 

I ) "i^noose one . 

[J Enclosing subparameter, indicates that subparameter is optional; If more than one line is enclosed, choose one or none. 

[j Enclosing entire parameter, indicates that parameter may be optional, depending on what type of data set you are defining. 



The DD Statement (con't) 



''Nan-ie 



Operation 



Operand 



// 



ddname 
cccs^epname 
ddname 



DD 



(n, CYL, (primary quantity j_, secondary quantity J )) 



SPLIT= n 



j (percent, blocklength, (primary quantity [_, secondary cuantity )"]) 
(percent 



SUBALLOC=( 



TRK 1 [ , ddname j 

CYL I , (primary Tsecondaryl Qdirectory] ) j ,stepname. ddname 1) 

blocklength I , I , stepname. procstepname. ddname) 



'SYSOUT=classname 



SYSOUT=(classname r, program name IQform number] ), LOUTLIM=number] 



r, program name] 



UCS=(character set code r,FOLD][",VERIFY] 



unit address 

|UNIT=( device type 

group name 

IUNiT=AFF=^dname 



pOLDll 



,unit count 
,P 



[,DEFER] [ ,SEP=(ddname, . . .)] ) 



VOLUME (=( [private] TRETAINir, volume seq #][, volume count] [,] 



VOL 



SER=(serial number,...) 

REF=dsname 

REF=*. ddname 

REF=*, stepname. ddname 

REF=* . stepname . procstepname 



Chart 3 



Section X] 



^e DD Statement 



perand 



[,list of attributesj) 



Jdname 



vVORDir,IN 1 [,] rEXPDT=yyddd]) 
J L'OUTJ [RETPD=nnnn J 



idary 



.directory 
.index 



) ,RLSE 



,CONTIG 

,MXIG 

,ALX 



[, round] ) 



ir,directory1)) 
|_, index J 



P/K 



Comments 



To define a data set in the input strec 



To bypass I/O operations on a data set 
(BSAM and QSAM) 

One way to request channel separation 



To complete the data control block. See 
Glossary of DCB Subparameters. 



To postpone the definition of a data set 



To assign a status, disposition, and 
conditional disposition to the data set 



To assign a name to a new data set or to 
identify an existing data set. An 
unqualified name is 1-8 characters, 
beginning with an alphabetic or national 
character. 



To supply label information 



One way to request channel separation. 
Code up to 8 ddnames. 



To assign space on a direct access volume 
for a new data set 

"To assign specific tracks on a direct access 
volume for a new data set 



then one line is eic'osed, choose o"e or none. 
lepending on what ''ype of data set yoj are defining. 



The DD Statement (con't) 



//Nc 



ddname 
procstepnome, 
ddname 



L 



Operation 



DD 



Operand 



I (n,CYL, (primary quantity L, secondary quantity j )) 
n I 

(percent, blocklength, (primary quantity |_,secondary quantity)"]) j 
percent 



SUBALLOC=( 



TRK 
CYL 

blocklength 



(primary Tsecondaryl LdirectoryJ ) 



r secondary 1 



, ddname I 

,stepname. ddname j ) 

, stepname . procstepnome .dd name ) 



^SYSOUT=classname 

2SYSOUT=(classname r,program namel Qform number]] ), [OUTLIM=numberj 



UCS=(character set code r,FOLDl QvERIFY]) 



UNIT=( 



unit address 
device type 
arouD name 



pOLDll 



,unit count 
,P 



[,D EFER] [ ,SEP=(ddname ,...)]; 



UNIT=AFF=ddname 



JVOLUME I=([pRIVATE] r,RETAIN"] f", volume seq #1[, volume count] [,] 



SER=(serial number,.,.) 

REF=dsname 

REF=*. ddname 

REF=*. stepname. ddname 

R EF=* . stepname . procstepnome .dd name 



P/K 



Comments 



To assign space on a direct access volume 
for a new data set. Data sets share cylinders. 



To request part of the space on a direct 
access volume assigned earlier in the job 



To route a data set through the output 
stream. For classnome, assign A-Z or 
0-9. ■' For PCP. 2 For MFT and MVT. 



To request a special character set for a 
1403 printer 



To provide the system with unit information 



To provide the system with volume information 



Chart 3 
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